Skip to main content
GET
Get maker capital

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.

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. Never 0.

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.

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. Both are currently UNAVAILABLE with a blocker until their action policy is qualified.

reservations
object[]
required

Venue reservations on MAKER_VAULT that make up pending_commitments.