Skip to main content
GET
List quote history

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.

Headers

Origin
string<uri>

Required for browser sessions; API keys do not require an Origin.

Path Parameters

maker_id
string<uint64-decimal>
required

On-chain maker ID, as a decimal string. An API key may only name the maker it is bound to; other makers return 404.

Maximum string length: 20
Pattern: ^(0|[1-9][0-9]{0,18}|1[0-7][0-9]{18}|18[0-3][0-9]{17}|184[0-3][0-9]{16}|1844[0-5][0-9]{15}|18446[0-6][0-9]{14}|184467[0-3][0-9]{13}|1844674[0-3][0-9]{12}|184467440[0-6][0-9]{10}|1844674407[0-2][0-9]{9}|18446744073[0-6][0-9]{8}|1844674407370[0-8][0-9]{6}|18446744073709[0-4][0-9]{5}|184467440737095[0-4][0-9]{4}|18446744073709550[0-9]{3}|18446744073709551[0-5][0-9]{2}|1844674407370955160[0-9]|1844674407370955161[0-5])$

Query Parameters

from
string<date-time>
required

Inclusive RFC3339 start of the period on submitted_at.

through
string<date-time>
required

Exclusive RFC3339 end of the period; must be after from.

status
enum<string>

Return only quotes with this status. The fill rate ignores it. Where the quote stands now. OPEN: live and acceptable. AWAITING_CONFIRMATION: the taker accepted it and the maker has not answered within its two-second deadline yet. ACCEPTED: the maker confirmed and the trade is queued or on its way to chain. FILLED: the trade committed on chain. FAILED: the trade reverted or expired unexecuted. DECLINED: the maker declined the acceptance. TIMED_OUT: the maker did not answer the acceptance in time. CANCELLED: the maker withdrew the quote. REPLACED: the maker's newer quote on the same RFQ replaced it. EXPIRED: it or its RFQ lapsed unaccepted. NOT_SELECTED: the RFQ's taker accepted another quote first. RFQ_CANCELLED: the taker cancelled or replaced the RFQ.

Available options:
OPEN,
AWAITING_CONFIRMATION,
ACCEPTED,
FILLED,
FAILED,
DECLINED,
TIMED_OUT,
CANCELLED,
REPLACED,
EXPIRED,
NOT_SELECTED,
RFQ_CANCELLED
kind
enum<string>

Return, and compute the fill rate over, only quotes of this kind.

Available options:
ENTRY,
CASHOUT
limit
integer
default:50

Maximum items per page, 1 to 200, default 50. A page may hold fewer, even none, while has_more is true. Maximum items in one page. A page may hold fewer, even none, while has_more is true.

Required range: 1 <= x <= 200
cursor
string

Omit for the first page; then send the previous response's next_cursor unchanged. Opaque list cursor. Send a previous response's next_cursor back unchanged; never build or parse one.

Required string length: 1 - 2048

Response

One page of the maker's quotes with one freshness status; display fields only, never signatures, and amounts are atomic USDC strings. A quote's status follows its acceptance, the maker's answer and the trade's chain outcome first, then the quote's book state, then its RFQ. A decline carries no reason, since the maker's answer records none. No shared caching.

Every quote the maker published in a period, not only live ones, with the period's fill rate.

context
object
required

Freshness of this read. Quotes are venue rows read now; FILLED and FAILED follow the vault projection, so as_of is its checkpoint and status is STALE while it lags.

from
string<date-time>
required

Inclusive RFC3339 start of the period on submitted_at, echoed from the query.

through
string<date-time>
required

Exclusive RFC3339 end of the period, echoed from the query.

fill_rate
object | null
required

The period's fill rate, on a list's first page (no cursor); null on later pages and when the period holds more than 50,000 quotes: ask for a shorter one.

items
object[]
required

Quotes on this page, newest submitted_at first. Each status is read when the page is.

next_cursor
string | null
required

Opaque cursor for the next page; null on the last page. Send it back unchanged as cursor with the same filters.

Required string length: 1 - 2048
has_more
boolean
required

True exactly when next_cursor is non-null. A status-filtered page reads at most 1,000 quotes, so it may hold fewer items than limit, even none, while has_more is true.