ARarbital
Execution Quotes

POST /v3/quote

Authenticates the caller, forwards exact inputs and principal wallet addresses to the private gRPC Quote service, and returns quote_id plus the signed payload after Redis storage succeeds. The API gateway performs no additional balance or metadata reads. Client-supplied identity, wallet addresses and decimals are rejected. An explicit amount_atomic is required; sell_all is rejected. When prepared execution is explicitly enabled, the winning eligible DFlow Solana USDC quote contains validated, simulated, sponsor-signed transaction bytes in prepared_transaction. Quote reads fresh chain balances and mint metadata for this preparation. Authenticated POST /v1/execute with quote_id approves user signing and submission through the existing enrolled backend signer; no extra client signature is required. Acceptance and submission must occur before the same signed expiry. Other routes remain price discovery only and cannot be executed by quote ID. Existing /v2/quote behavior is unchanged. Requires QUOTE_GRPC_TARGET, otherwise returns 503.

Request

  • Base URL
    https://api.arbital.xyz (the document declares no server; this is the origin it was published from)
  • URL
    https://api.arbital.xyz/v3/quote
  • Auth
    HTTP bearer

Request body

amount_atomicstring required

Explicit exact source amount in atomic units, bounded to uint256. No balance lookup is performed; sell_all is not supported.

slippage_bpsinteger required

Response

Signed quote stored; ID and the exact signed payload.

quote_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.