Skip to main content
PUT
Keep quote lease

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.

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

Body

application/json

Arm or renew your quote lease. Each renewal sets it to lapse lease_ms after the server receives it; it covers the whole maker, whichever key renews it. Without a lease nothing changes. Send no Idempotency-Key: a repeat only renews again.

lease_ms
integer
required

How long your quotes stand without another renewal, in milliseconds, from 1000 to 60000. Renew well inside it, for example every third of it.

Required range: 1000 <= x <= 60000

Response

The armed lease and when it lapses.

Your armed quote lease. Your quotes stand while it is live. Once it lapses, the venue cancels each of your open quotes that no taker is accepting, as DELETE /v1/quotes/{quote_id} would, and keeps cancelling the quotes you publish until you renew or release it. Takers see each one leave as QUOTE_REMOVED with status CANCELLED.

lease_ms
integer
required

The lease length you sent, in milliseconds.

Required range: 1000 <= x <= 60000
expires_at
string<date-time>
required

When the lease lapses unless you renew it first: the server's time of this renewal plus lease_ms, 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$