GET
Get a quote's status

Authorizations

x-api-key
string
header
required

A partner's API key. Optional: without it a request is anonymous. An invalid key is 401 unauthorized.

Path Parameters

id
string
required

The quote's ID

Response

The quote's status

GET /v1/quote/{id}.

createdAt
integer<int64>
required

When the firm quote was made, in Unix seconds.

Required range: x >= 0
destination
object
required

The destination leg of a quote's status.

expiresAt
integer<int64>
required

As in the firm quote. Escrows: the deposit deadline. Swaps: the time to send by. Unix seconds.

Required range: x >= 0
id
string
required
source
object
required

The source leg of a quote's status.

status
enum<string>
required

A quote's public status (design/03-server.md, Quote lifecycle).

Available options:
awaiting_deposit,
deposit_confirmed,
in_progress,
completed,
refunded,
expired
costBps
integer<int64> | null

The fees' total in basis points of from.usd: from.usd − to.usd, plus the sender's own gas on the source chain when network includes it. Everything the user gives up, when known.

Required range: x >= 0
depositAddress
string | null

An escrow quote's deposit address, as in the firm quote's execute; absent for swaps.

destinationSeenAt
integer<int64> | null

When the server first saw the solver's destination escrows on chain, before they were confirmed, in Unix seconds. From sourceConfirmedAt to this is how long the swap took to fill. Escrows only; absent until the escrows paying the recipient are confirmed.

Required range: x >= 0
etaSecs
integer<int64> | null

Seconds from the deposit (or the swap) being seen until the recipient is paid, as estimated at quote time.

Required range: x >= 0
fees
object | null

The fees at quote time, when known.

priceImpactBps
integer<int64> | null

What the route loses against market price, router fees included, in basis points of from.usd, when known.

Required range: x >= 0
sourceConfirmedAt
integer<int64> | null

When the server saw the source deposit confirmed, in Unix seconds. Escrows only; absent until then.

Required range: x >= 0