Skip to main content
GET
Get RFQ

Authorizations

Authorization
string
header
required

Scoped API key from the Totalis app settings. 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.

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 RFQ; its owner can also read it after it ends, to see how it ended.

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}$
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).

Available options:
OPEN,
ACCEPTED,
EXPIRED,
CANCELLED,
FAILED
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 created quote stays acceptable until its own expiry.

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, or it expired unexecuted. Present only when status is FAILED.

Available options:
REVERTED,
EXPIRED_UNEXECUTED
intent_id
string<uuid>

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

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)$