Skip to navigation

Get a Quote by ID

Retrieve a quote exactly as POST /v0/quotes returned it. Use it to recover a quote’s executionSteps, fees, or transactionId after the fact, not to track progress: nothing on a quote changes after creation, transactionId included.

An expired quote is still returned, so check expiresAt before running its steps, and request a new quote once it has passed. To follow a conversion, poll GET /v0/transactions/{txnId} with the quote’s transactionId instead (see Tracking execution).

404 quote_not_found covers both an unknown id and another organization’s quote, so the response doesn’t reveal whether a quote exists elsewhere.

Authentication

AuthorizationBearer

Session JWT from POST /v0/auth/token, sent as Authorization: Bearer <sessionJwt>.

See Authentication for more details.

Path parameters

quoteIdstringRequiredformat: "uuid"

Response

OK
idstringformat: "uuid"
providerenum

Which provider executes this quote. relay is the only value today; further providers join as their integrations land.

Allowed values:
createdAtdatetime
expiresAtdatetime
Deposit must land onchain by this time.
senderobject
receiverobject
senderAmountstringformat: "^\d+(\.\d+)?$"

Amount in decimal token units, ex. 10.00.

receiverAmountstringformat: "^\d+(\.\d+)?$"

Amount in decimal token units, ex. 10.00.

slippageBpsinteger>=0
Effective value after the chain's default and cap.
feesobject

Cost breakdown in USD. Informational: nothing here is deducted from senderAmount or receiverAmount, which already reflect the quoted rate.

executionStepslist of objects

Ordered steps the caller executes in turn to fulfill the quote. erc20Approve appears only when the sender’s existing allowance is insufficient. New action values may be added; tolerate unknown ones.

transactionIdstringformat: "uuid"

Poll GET /v0/transactions/{txnId} with this. 404 until the deposit is observed.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error