Request a firm quote with transaction packet

post

https://api.rave-trading.com/api/v2/quotes/firm

Returns a binding quote with a public transaction packet ready for wallet submission. A caller may supply quote_attempt_id to claim one durable logical attempt: exact retries replay one unexpired response, while changed tuples or ownership conflict. For every execution route, transaction.to remains the Rave SettlementRouter address for the requested chain; partners should never approve or submit to any other address. Integrators must verify expiry, chain, target contract, allowance, balance, and local transaction data safety before asking the wallet to sign. The API does not sign or broadcast for the user.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

amount

string

required

^[0-9]+$

Defaults to 100000000000000000000

Raw base-unit amount of token_in. The trade direction is defined only by token_in -> token_out; the settlement transaction is capped so it cannot pull more than this token_in amount. Use token_in.decimals from the discovery endpoints to convert human-readable sizes.

chain_id

integer

required

Defaults to 56

Chain ID (56 for BNB Smart Chain, 1 for Ethereum, 8453 for Base, 1672 for Pharos, 4663 for Robinhood Chain, 5042 for Arc).

deadline

int64

Optional absolute Unix timestamp in seconds: quote expiry never exceeds it. Soft validity is rounded down to whole seconds; an elapsed deadline or less than one whole second remaining is refused with HTTP 400 instead of receiving a fresh lifetime. Omit to use the normal quote lifetime.

end_user

string

Optional address of the wallet that will trade, which can differ from recipient. Metadata only, like source: it never changes where tokens settle, which is always recipient. Omitting it is always safe.

recipient

string

required

Your wallet address. This is where the output tokens settle: the firm-quote transaction packet pays out to this address. Replace the placeholder with a wallet you control before requesting a firm quote. Never use a burn or zero address.

slippage_bps

integer

0 to 10000

Slippage tolerance in basis points. When omitted, the engine selects the applicable default for the route. Set 0 only when you require a binary exact-fill quote.

source

string

length ≤ 64

Optional application label, such as a wallet or dapp name: at most 64 characters, trimmed and case-insensitive. Metadata only: not a price input, not echoed in the quote, and not part of the quote_attempt_id identity. Omitting it is always safe.

token_in

string

required

Defaults to 0x55d398326f99059ff775485246999027b3197955

Contract address of the token the taker sends on chain_id. Choose token_in/token_out pairs from the assets, limits, or market-levels endpoints; amount is encoded with this token's decimals.

token_out

string

required

Defaults to 0x390a684ef9cade28a7ad0dfa61ab1eb3842618c4

Contract address of the token the taker receives on chain_id. Must be paired with token_in for a supported market on that chain.

quote_attempt_id

uuid

Optional caller-owned durable logical attempt identity. Reuse only for an exact retry of the same firm request. A changed tuple/owner conflicts; a completed or expired attempt requires a new UUID.

Responses

200Firm quote with transaction data. Firm quotes include execution.transaction ready for wallet submission.

400Invalid request input. Coded cases: amount_not_raw_integer, outside_notional_range, recipient_funding_insufficient, provider_request_rejected, trial_order_too_large. Correct the request; do not retry unchanged.

401Missing or invalid Bearer token. The body is the same flat JSON error object used by all error responses.

403The API key lacks a required scope; code route_requires_solver_assignment needs an authenticated solver assignment; trial_access_paused, trial_pair_not_allowed, and trial_recipient_not_allowed are fail-closed trial-key refusals. Do not retry unchanged.

404Resource not found.

429code caller_rate_limited means an identical firm operation was repeated too often; code trial_daily_limit_reached means the trial key's rolling firm-quote window is full. Honor Retry-After (also in retry_after_secs) before retrying.