Skip to main content
GET
Get acceptance

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

quote_id
string
required

The quote's quote_id, from QUOTE_CREATED, QUOTE_ACCEPTED or Create quote.

Pattern: ^0x[0-9a-f]{64}$

Response

The acceptance as it stands now, whichever key or session made it. Reading it moves no funds.

The one record of a taker accepting a quote.

acceptance_id
string<uuid>
required

The Idempotency-Key the taker sent with the accept, which names this acceptance. Never sent to the maker.

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

The accepted quote. A quote has at most one acceptance.

Pattern: ^0x[0-9a-f]{64}$
rfq_id
string<uuid>
required

RFQ the quote answers.

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

PENDING_CONFIRM: waiting for the maker. PENDING_FUNDING: the maker confirmed an entry whose HyperCore payment is still pending. ACCEPTED: the maker confirmed and the trade is queued as operation_id. FILLED: the trade committed on chain. FAILED: it reverted or expired unexecuted. DECLINED: the maker declined. TIMED_OUT: the maker did not answer by deadline. CANCELLED: the quote or RFQ went away first, or the HyperCore payment failed.

Available options:
PENDING_CONFIRM,
PENDING_FUNDING,
ACCEPTED,
FILLED,
FAILED,
DECLINED,
TIMED_OUT,
CANCELLED
deadline
string<date-time>
required

When the maker's time to confirm ends, two seconds after the accept, as an RFC3339 UTC timestamp.

Maximum string length: 30
Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}([.][0-9]{1,9})?Z$
operation_id
string

The on-chain operation that executes the trade; present once status is ACCEPTED, FILLED or FAILED.

Pattern: ^0x[0-9a-f]{64}$