Markets and limits

Before you quote, read what is live. Four endpoints answer four questions:

All of these are live. Never hard-code a pair, a chain or a decimals value.

Assets

GET /v2/assets is the catalog for a token picker. Each asset has a category (tokenized_equity, tokenized_fund, stablecoin, or other), price, market, and one chains[] entry per chain with its token and same-chain quote_tokens. ?address=0x... narrows it to one token contract.

curl -s "$RAVE_API/v2/assets" -H "Authorization: Bearer ***" \
  | jq '.[] | {symbol, category, chains: [.chains[] | {chain_id, token: .token.address, quote_tokens: [.quote_tokens[].address]}]}'

The catalog can lag a newly launched chain, so treat /v2/markets/levels as the source of truth for what quotes.

🚧

Decimals are per token, per chain

USDC has 18 decimals on BNB Smart Chain and 6 on Ethereum and Base. A decimals value carried across chains is wrong by a factor of 10^12. Base tokens differ too: they are not always 18 decimals, and some on Base use 8. Always read decimals for the exact token address and chain you quote.

Market levels

GET /v2/markets/levels returns the pair books published right now: bid and ask levels, size bounds, and per-side quoteability.

# Which chains publish pairs right now
curl -s "$RAVE_API/v2/markets/levels" -H "Authorization: Bearer ***" \
  | jq '[.pairs[].chain_id] | group_by(.) | map({chain_id: .[0], pairs: length})'

Each side's quoteability carries status, tradable, size limits and input_capability (see Variable Input). allowance_target is not on levels; read it from /v2/limits. Do not route against a pair where available is false.

Limits

GET /v2/limits is the pre-quote gate. Each assets[] entry is one asset on one chain; the chain is token.chain_id. Filter with symbol and chain_id.

curl -s "$RAVE_API/v2/limits?symbol=BASE_SYMBOL&chain_id=$CHAIN_ID" -H "Authorization: Bearer ***" \
  | jq '.assets[] | {symbol, chain_id: .token.chain_id, status: .sides.buy.status, tradable: .sides.buy.tradable, min_input: .sides.buy.limits.min_input_amount, max_input: .sides.buy.limits.max_input_amount, remaining_executions: .sides.buy.remaining_executions}'

Session-wide capacity is in the top-level session object (status, remaining_quotes, max_quotes, reason_code). Its fields can be null when the snapshot is unavailable. Check tradable first: a closed side can have null or "0" bounds.

For both levels and limits, read the side's minimums_known separately from availability. false means the executable minimum is unknown in the published sizing envelope; it does not close an otherwise tradable side or establish an executable zero-sized order. Minimum amounts can be null; legacy token-amount objects and aggregate min_base_amount can instead carry "0" as an open lower bound when source minimums are unknown. Do not invent a minimum from that carrier or from the first depth level. Request a positive, representable amount within the published maximum and let the firm quote establish acceptance. A known zero policy floor still requires token precision, fees, funds, depth and settlement checks. If the flag is absent, retain compatibility with the published bounds rather than assuming it is false. These trading bounds are separate from the signed variable-input settlement window.

Market status

GET /v2/markets/status returns camelCase session state: isOpen, status, marketStatus, offhoursIsOpen, a nested snake_case market snapshot, sessionLimits, assetTradability ([{ symbol, tradable }]) for the session named by assetTradabilitySession, nextOpen, nextClose, nextOpenSession and updatedAt.

Tokenized stocks trade in sessions (premarket, regular, postmarket, overnight). A pair can stay quotable in /v2/markets/levels while /v2/markets/status reports the regular session closed. Gate each trade on the pair's own side, quoteability.<side>.tradable or sides.<side>.tradable, and show nextOpen when a side is closed.

Units

A multi-chain asset appears once per chain_id. Key on (symbol, chain_id) or the token address, never on symbol alone.