BOU Wallet

Use direct HTTP requests with curl. Prefer this skill when the task is to operate this backend through an existing agent bearer key instead of building a separate SDK or CLI first.

First-time setup after install

If the user has installed this skill but does not have an agent API key yet, walk them through this setup first:

1. 1. Open INLINECODE1
2. Sign in, then create an agent in the app
3. Generate the agent API key, then copy it and use it as AGENT_KEY in requests

If the user has not completed these steps yet, do not pretend the skill can run successfully. First help them obtain a valid ak_... key.

Required inputs

Collect these values before making any request:

• - BASE_URL: use https://api.bankofuniverse.org/ unless the user explicitly gives a different backend
• INLINECODE6: bearer token in ak_... format

Treat the agent key as secret. Do not print, commit, or store it in repo files.

Common request pattern

Use the same bearer auth for all three capability groups.

CODEBLOCK0

For JSON request bodies, also add:

CODEBLOCK1

Most responses use the shared wrapper:

CODEBLOCK2

Capability 1: x402 pay-and-call

Use POST /agent/pay-and-call when the agent needs to access an x402-protected upstream URL through this backend. Call this backend endpoint, not the merchant directly.

Body shape:

CODEBLOCK3

Rules:

• - Send a full upstream http:// or https:// URL in INLINECODE11
• Use the upstream HTTP verb in INLINECODE12
• Pass merchant headers as a JSON object when needed
• Pass body only when the upstream endpoint expects one
• The backend enforces agent status and USDC payment limits before paying
• The backend rejects requests when the required payment is >= 0.1 USDC

Example:

CODEBLOCK4

x402 test cases

Use these upstream URLs to quickly test the pay-and-call flow.

Test case 1: random number

Upstream endpoint:

• - INLINECODE16

Expected response body:

CODEBLOCK5

Example:

CODEBLOCK6

Test case 2: crypto price

Upstream endpoint:

• - INLINECODE17

Supported symbols:

• - INLINECODE18
• INLINECODE19
• INLINECODE20
• INLINECODE21
• INLINECODE22
• INLINECODE23

Expected response body:

CODEBLOCK7

Example:

CODEBLOCK8

Capability 2: current agent info

Use GET /agent/me to inspect the current agent resolved by the bearer key.

This endpoint returns the resolved agent, matched API key metadata, cumulative spent USDC, and a best-effort Base USDC balance lookup.

Example:

CODEBLOCK9

Capability 3: Hyperliquid operations

Use the /hyperliquid endpoints when the agent needs to inspect or trade through the backend's Hyperliquid integration. All requests use the same bearer auth pattern.

Read endpoints

• - INLINECODE26

Purpose: verify the current agent is authorized to use Hyperliquid for the resolved account. Key return fields: address is the resolved Hyperliquid account address. In agent mode, the response may also include signer-related identity information returned by the backend. Use it when: you want to confirm the bearer key is valid and Hyperliquid access is ready before reading balances or sending orders.

• - INLINECODE28

Purpose: fetch the latest account balance snapshot from Hyperliquid. Key return fields: data contains the balance payload returned by Hyperliquid for the resolved account, including available funds and account balance details. Use it when: you need to check available funds before trading, transferring, or withdrawing.

• - INLINECODE30

Purpose: list current open orders, optionally filtered by one symbol. Key return fields: each item is normalized to include readable coin, side, and marketType; the rest of the item is the underlying open-order data. Use it when: you want to inspect working orders before canceling or placing another order.

• - INLINECODE34

Purpose: list supported spot or perp markets. Key return fields: spot markets include fields such as coin, pairId, base, quote, szDecimals, weiDecimals, and marketType; perp markets include fields such as coin, base, quote, dexName, maxLeverage, szDecimals, onlyIsolated, marginMode, and marketType. Use it when: you need to discover valid symbols, decimals, supported dex markets, or leverage-related metadata before trading.

• - INLINECODE51

Purpose: inspect the current account trading state for one perp coin. Key return fields: coin, leverage, isCross, leverageType, maxTradeSzs, availableToTrade, and markPx. maxTradeSzs and availableToTrade are two-element arrays: index 0 is the BUY value and index 1 is the SELL value. Use it when: you need the current leverage mode, tradeable size, or mark price for a perp coin before placing or sizing an order.

• - INLINECODE65

Purpose: fetch current and next funding information for one perp market. Key return fields: coin, fundingRate, nextFundingRate, nextFundingTimestamp, markPrice, and indexPrice. Use it when: you want to evaluate funding cost, expected next funding, or compare mark price with oracle/index price.

• - INLINECODE72

Purpose: fetch the live L2 order book for one market. Key return fields: data is the raw Hyperliquid order book snapshot, including bid and ask levels plus the snapshot time. Use it when: you need market depth, best bid/ask context, or raw book levels for quoting and execution logic.

• - INLINECODE74

Purpose: list current perp positions across available dex contexts for the account. Key return fields: each position includes dexName, marketType, coin, szi, leverage, isCross, leverageType, entryPx, positionValue, unrealizedPnl, returnOnEquity, liquidationPx, marginUsed, maxLeverage, and cumFunding. Use it when: you want a full view of current exposure, PnL, liquidation risk, and leverage usage.

• - INLINECODE90

Purpose: list historical fills for the account, optionally filtered by symbol, start time, and result count. Key return fields: each fill is normalized to include readable coin, side, and marketType; the rest of the fill fields come from Hyperliquid's fill history. Use it when: you want recent execution history for trade reconciliation, reporting, or strategy logic.

• - INLINECODE94

Purpose: fetch a compact ticker-style market snapshot for one symbol. Key return fields: coin, marketType, last, bid, ask, open, close, change, percentage, volume, quoteVolume, and timestamp. Use it when: you need a lightweight summary of current price, spread, daily move, and volume without reading the full order book.

Query rules:

• - marketType: perp or INLINECODE109
• INLINECODE110: short asset symbol such as BTC or INLINECODE112
• INLINECODE113 for fills: 1 to INLINECODE115
• INLINECODE116 for orderbook: 2, 3, 4, or INLINECODE120
• INLINECODE121 for orderbook: 2 or INLINECODE123

Write endpoints

• - INLINECODE124
• INLINECODE125
• INLINECODE126
• INLINECODE127
• INLINECODE128
• INLINECODE129

Place order

Request body:

CODEBLOCK10

Field rules:

• - orderType: market, limit, stop_limit, stop_market, or INLINECODE135
• INLINECODE136: BUY or INLINECODE138
• INLINECODE139: numeric string
• INLINECODE140: optional in the DTO, but required for limit-style orders such as limit and INLINECODE142
• INLINECODE143: optional in the DTO, but use it for stop orders such as stop_limit and INLINECODE145
• INLINECODE146 and slPrice: optional take-profit and stop-loss values
• INLINECODE148: Gtc, Ioc, or INLINECODE151
• INLINECODE152: optional in the DTO, min 5, max 1440; use it for TWAP-style flows when required by the backend logic
• INLINECODE155: optional boolean for TWAP-style flows

Example:

CODEBLOCK11

Cancel selected orders

Request body:

CODEBLOCK12

Field rules:

• - orders: required array with at most 100 items
• INLINECODE158: required string for each item
• INLINECODE159: required integer for each item, minimum INLINECODE160

Cancel all orders

Request body:

CODEBLOCK13

Omit coin to cancel all open orders across supported assets.

Set leverage

Request body:

CODEBLOCK14

Transfer asset

Request body:

CODEBLOCK15

Field rules:

• - amount: required numeric string
• INLINECODE163: optional dex name string; omit it to use the primary dex.
• INLINECODE164: optional boolean, true means transfer from perp side

Withdraw asset

Use this endpoint to withdraw Perps USDC to the Arbitrum network.

Request body:

CODEBLOCK16

Field rules:

• - destination: required EVM address
• INLINECODE167: required numeric string

Execution checklist

Before running requests:

• - Verify BASE_URL is correct
• Verify the token looks like INLINECODE169
• Verify JSON is valid
• Verify Hyperliquid enum values match the accepted casing exactly
• Prefer the two built-in x402 test cases above when validating a new agent key
• Use -i when you need status codes or headers for debugging

If a request fails, inspect the wrapped JSON message plus the HTTP status first.