Skip to main content
GET
Get maker capital

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

vault:read

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

Response

Your maker capital, reconciled against the vault contract. Check it before you quote: a confirm fails when your capital cannot cover the fill. Read it again on every MAKER_CAPITAL_UPDATED. One freshness status covers the read; amounts are atomic USDC strings or null. No shared caching.

Maker capital lanes and derived collateral, in atomic USDC (6 decimals, "1000000" = 1 USDC). Amounts are null when unavailable; context.status is their freshness.

context
object
required

Freshness of this read: the oldest source observation and one status for every amount in the response.

owner
string
required

Maker owner (its controller) from the same indexed vault row as the lanes.

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

Maker signer (its quote signer) from the same indexed vault row as the lanes. The zero address means the maker was opened without one and cannot quote.

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

Maker vault lane V from the vault contract, including escrow and payables.

Pattern: ^(0|[1-9][0-9]{0,77})$
stake_escrow
string | null
required

Bettor net stakes escrowed in this maker's open tickets (E).

Pattern: ^(0|[1-9][0-9]{0,77})$
payable_owed
string | null
required

Settled winnings owed to ticket holders and not yet claimed (P).

Pattern: ^(0|[1-9][0-9]{0,77})$
gross_open
string | null
required

Original open maker exposure G: payout minus net stake summed over open tickets.

Pattern: ^(0|[1-9][0-9]{0,77})$
discount
string | null
required

Maker discount lane D from the vault contract, which offsets gross_open in the requirement.

Pattern: ^(0|[1-9][0-9]{0,77})$
requirement
string | null
required

Collateral requirement R = max(G - min(D, G), ceil(G * floor_bps / 10000)) under the pinned release; null when floor_bps is null or an input is null.

Pattern: ^(0|[1-9][0-9]{0,77})$
free_collateral
string | null
required

Collateral headroom F = max(V - E - P - R, 0). Not a guarantee of quote acceptance.

Pattern: ^(0|[1-9][0-9]{0,77})$
capital_net_of_senior_liabilities
string | null
required

Signed C = V - E - P. Excludes open-ticket valuation; not equity or NAV.

Pattern: ^(0|-?[1-9][0-9]{0,77})$
pending_commitments
string | null
required

Admission reservations H the venue holds for this maker that are not yet reflected on-chain; the sum of reservations.

Pattern: ^(0|[1-9][0-9]{0,77})$
free_after_pending
string | null
required

max(F - H, 0): free collateral after unreflected commitments. Not private bot capacity.

Pattern: ^(0|[1-9][0-9]{0,77})$
floor_bps
integer | null
required

Requirement floor K in basis points from the pinned release; null when the on-chain comparison mismatches, which makes requirement UNAVAILABLE.

Required range: 0 <= x <= 10000
deployment_digest
string
required

SHA-256 of the exact pinned artifact that names this deployment's chain and vault: the release artifact on chain 999, the environment's deployment manifest on 998. A client compares it with its own pinned artifact to bind the read to its deployment.

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

Decisions for MAKER_WITHDRAW and MAKER_QUOTE on the MAKER_VAULT route. MAKER_WITHDRAW is the amount a new withdrawal request may ask for: free_after_pending, so it never takes collateral from fills already admitted. The vault re-checks free collateral when the request executes after its delay; it is null with MAKER_WITHDRAW_PENDING while a request is live, or with a reconciliation blocker. MAKER_QUOTE is the most new quotes may promise: free_after_pending less a live v1 withdrawal request's amount, never below zero. Quotes reserve nothing, so it does not count the maker's other live quotes; if several are accepted at once, a confirm past it fails QUOTE_CAPACITY_EXCEEDED. Both are null with a reconciliation blocker while the vault read and venue records disagree.

reservations
object[]
required

Venue reservations on MAKER_VAULT that make up pending_commitments.