Skip to main content
GET
Get RFQ

Authorizations

Authorization
string
header
required

Scoped API key (ttk_...), created in the Totalis app or by a wallet-session user through the API keys routes with a fresh wallet signature; those routes never accept a key. Each key acts for one account, yours or a maker's, and holds only scopes that account can use. Each operation lists the scopes it requires. Send no Origin.

Scopes

rfq:read

Path Parameters

rfq_id
string<uuid>
required

The RFQ's rfq_id, from Create RFQ or RFQ_CREATED.

Response

The RFQ as it stands now. Anyone can read an open entry RFQ; an open cash-out is read only by its owner or with its backing maker's credential. Its owner can also read it after it ends, to see how it ended.

status
enum<string>
required

OPEN collects quotes until expires_at; EXPIRED means that window passed without an accepted quote; CANCELLED means the owner cancelled it or a newer intent generation replaced it; ACCEPTED means a quote was accepted and confirmed; FAILED means the accepted trade failed on chain (see terminal_reason); DECLINED means every maker that could answer declined to quote it before expires_at.

Available options:
OPEN,
ACCEPTED,
EXPIRED,
CANCELLED,
DECLINED
intent_id
string<uuid>
required

Automatic-RFQ intent this RFQ belongs to; absent for RFQs created without one.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
intent_generation
string
required

Generation of the intent this RFQ was created for, as a decimal string; absent together with intent_id.

Maximum string length: 19
Pattern: ^([1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6]|9223372036854775807)$
rfq_id
string<uuid>
required

Identifier of this RFQ (UUID).

kind
any
required

RFQ kind; ENTRY asks makers to quote a new position.

taker
string
required

Wallet that signs the accept and will own the position.

Pattern: ^0x[0-9a-f]{40}$
stake
string
required

Stake in atomic USDC (6 decimals), before taker fees.

Pattern: ^[1-9][0-9]{0,38}$
created_at
string<date-time>
required

When the RFQ was durably created, RFC3339 UTC.

expires_at
string<date-time>
required

When quote collection ends, 20 seconds after creation. A quote created by then stays acceptable until its own accept_before.

legs
object[]
required

Requested legs in strictly increasing outcome_id order.

Required array length: 1 - 50 elements
terminal_reason
enum<string>

Why a FAILED RFQ ended: the accept transaction reverted (REVERTED), it expired unexecuted (EXPIRED_UNEXECUTED), or the taker's Cash did not cover the stake when it was to execute (INSUFFICIENT_CASH). The accept's operation then has failure_reason INSUFFICIENT_CASH. Present only when status is FAILED.

Available options:
REVERTED,
EXPIRED_UNEXECUTED,
INSUFFICIENT_CASH
net_stake
string<uint128-decimal>

What the vault backs if a quote is accepted, in atomic USDC (6 decimals): stake - floor(stake * taker_fee_bps / 10000), with the taker_fee_bps every quote must carry (the vault's current taker fee). Price the position on this; quotes still sign the gross stake. Absent while the taker fee is unknown.

Maximum string length: 39
Pattern: ^(0|[1-9][0-9]*)$