# Calibri

- [Welcome to Calibri](https://docs.calibri.io/introduction.md): Trade binary YES/NO prediction markets from a wallet only you control, settled in USDC on-chain.
- [Getting Started](https://docs.calibri.io/getting-started/overview.md): Create an account, set up your wallet, fund it, and place your first order — in one place.
- [How Prediction Markets Work](https://docs.calibri.io/how-prediction-markets-work.md): The intuition and economics behind trading on real-world outcomes.
- [Funding Your Account](https://docs.calibri.io/wallet-deposits.md): How funding works — USDC, and getting it into the Safe only you control.
- [Placing Orders](https://docs.calibri.io/trading-placing-orders.md): Placing a signed limit order, choosing YES or NO, buying or selling, and how a fill becomes a position.
- [Core Concepts](https://docs.calibri.io/concepts/core-concepts.md): Binary YES/NO markets, prices as probabilities, the combined order book, contracts, settlement, and the market lifecycle.
- [Recurring markets and windows](https://docs.calibri.io/concepts/recurring-markets.md): Series, windows, and price-feed markets — how a market that asks the same question every five minutes works, what the price line means, and what actually settles it.
- [How markets are resolved](https://docs.calibri.io/concepts/resolution-sources.md): The exact data each market settles against — Coinbase for crypto prices, official sports feeds for fixtures — how the deciding number is read, and why a settled market is never re-opened.
- [Requesting a market](https://docs.calibri.io/concepts/requesting-a-market.md): Suggest an event for Calibri to list — who can request one, why the gate is ten settled contracts rather than ten trades, and the submission limits that keep the queue readable.
- [Fees](https://docs.calibri.io/concepts/fees.md): Calibri charges a single taker fee, once, at the moment of the trade — price-dependent, highest at 50/50 and falling toward zero at the extremes. Makers pay nothing, and there is no settlement fee.
- [Rewards](https://docs.calibri.io/concepts/rewards.md): Two ways to earn on Calibri — market-maker rebates for providing liquidity and referral rewards for bringing traders. Both are a share of the taker fee, accrue live, and are paid by a daily sweep.
- [Maker Rebates](https://docs.calibri.io/concepts/maker-rebates.md): Makers pay no fee and earn a share of the taker fee on every fill of a resting order — fee-curve weighted, so the rebate peaks at 50/50 prices and fades toward the extremes.
- [Referral Program](https://docs.calibri.io/rewards-referral-program.md): Refer traders and earn a share of the fees on their trades.
- [Self-custody](https://docs.calibri.io/non-custodial/overview.md): How trading on Calibri works when the money never leaves your own on-chain Gnosis Safe.
- [Your wallet options](https://docs.calibri.io/non-custodial/wallets.md): Two ways to hold your funds on Calibri — a passkey wallet or your own wallet — both fully self-custody, both trading the same order book.
- [Balances](https://docs.calibri.io/non-custodial/balances.md): How your Safe balance (balance_safe / locked_safe / redeemable_safe) is reported, and how it moves.
- [The Safe](https://docs.calibri.io/non-custodial/the-safe.md): Your per-member Gnosis Safe — deploy and register (operator-gasless), fund with USDC, and make it trade-ready with signed approvals.
- [Deposits from other networks](https://docs.calibri.io/non-custodial/deposits-from-other-networks.md): Send USDC to your Safe address on Ethereum, Base, Arbitrum or Optimism and it arrives in the same Safe on Polygon — how it works, what it costs, what not to send, and why it stays non-custodial.
- [Withdrawals to other networks](https://docs.calibri.io/non-custodial/withdrawals-to-other-networks.md): Withdraw USDC from your Safe on Polygon to an address on Ethereum, Base, Arbitrum or Optimism — one signature, the fee shown before you sign, how long it takes, what happens if gas rises, and why Calibri cannot redirect it.
- [Signed orders (EIP-712)](https://docs.calibri.io/non-custodial/signed-orders.md): Build, sign, and place a non-custodial order — the EIP-712 Order domain and struct, 6-decimal unit rules, and the signed-order endpoint.
- [Trading without a prompt per order](https://docs.calibri.io/non-custodial/session-keys.md): Session keys — how a passkey wallet authorises one browser key to sign orders, what that key can and cannot do, and how to revoke it.
- [Signing keys](https://docs.calibri.io/non-custodial/signing-keys.md): Adding a second key that can sign for your wallet — what it enables, what it can do, how to remove it, and what happens if it removes your passkey.
- [Redeeming winnings](https://docs.calibri.io/non-custodial/redeeming-winnings.md): Resolving a market makes your winnings redeemable. Redeem them yourself with one relayed signature, or turn on auto-redeem and have them land in your Safe automatically.
- [Resolution, UMA & the deadman](https://docs.calibri.io/non-custodial/resolution.md): How a market resolves — what the outcome is judged against, then the operator report, UMA escalation, and the permissionless deadman void, with the timeframes for each.
- [Withdrawing without Calibri](https://docs.calibri.io/non-custodial/withdraw-without-calibri.md): How to move funds out of your Safe if Calibri is unreachable, has shut down, or refuses — what you need, what still works, and the one thing to keep alive.
- [Smart Contracts](https://docs.calibri.io/smart-contracts/overview.md): The on-chain contracts behind non-custodial trading — USDC, ConditionalTokens (CTF), the CTF Exchange, CalibriResolver, your per-member Gnosis Safe, and the bridge that brings USDC in from other networks — and how to verify the live addresses.
- [Deployed Addresses](https://docs.calibri.io/smart-contracts/deployed-addresses.md): Calibri's on-chain contract addresses — what is deployed, where to read the live values, and how to verify every one of them yourself on the block explorer.
- [Terms of Use](https://docs.calibri.io/terms-of-use.md): The rules that govern using Calibri — eligibility, custody, how markets settle, fees, and the limits of what Calibri is responsible for.
- [Privacy Policy](https://docs.calibri.io/privacy-policy.md): What Calibri collects, why, who it goes to, and what you can ask us to do with it.
- [Overview](https://docs.calibri.io/api-reference/introduction.md): Explore the APIs available for building with Calibri prediction markets.
- [End-to-end flow](https://docs.calibri.io/api-reference/quickstart.md): One pass through a working integration: read your wallet config, make the Safe trade-ready, fund it, sign and place an order, follow its status, and stream updates over the WebSocket.
- [Authentication](https://docs.calibri.io/api-reference/authentication.md): How to authenticate a private request: mint an API key and HMAC-sign every call.
- [Errors](https://docs.calibri.io/api-reference/errors.md): HTTP status codes and the dot-coded error strings the API returns — match on the code, not the status or the human text.
- [Rate Limits](https://docs.calibri.io/api-reference/rate-limits.md): Per-endpoint request allowances, how limits are keyed, and how to back off correctly when you hit one.
- [WebSocket streams](https://docs.calibri.io/api-reference/websockets.md): Real-time order book, candles, trades, underlying prices, and your own order/fill/balance updates — subscribed with stream query parameters on one connection.
- [Your orders](https://docs.calibri.io/api-reference/endpoints/trade/your-orders.md): Your prediction orders. Open (`wait`) rows come from the live engine index; terminal history (`done`, `cancel`, `reject`) from storage. Pass `state=wait` for the open-orders tab — that is what the product calls for resting orders, custodial and non-custodial alike. Placement path differs (Atlas sign…
- [Order by id](https://docs.calibri.io/api-reference/endpoints/trade/order-by-id.md): One of your orders. Open orders resolve from the live index; terminal ones fall back to history. Returns 404 for another member's order rather than 403.
- [Cancel an order](https://docs.calibri.io/api-reference/endpoints/trade/cancel-an-order.md): Cancels one of your open (`wait`) orders and refunds unmatched collateral. Same route for custodial and non-custodial resting orders — non-custodial placement is via Atlas; once resting, cancel is here. Terminal orders return 422.
- [Place a signed order](https://docs.calibri.io/api-reference/endpoints/trade/place-a-signed-order.md): Places a non-custodial order. `signed_order` is an EIP-712 signature over the CTF Exchange Order struct. Atlas validates it — a signature it cannot verify is rejected rather than placed — then relays to the engine and attaches the signature. Placing locks the stake PLUS the maximum taker fee the fil…
- [Activity feed](https://docs.calibri.io/api-reference/endpoints/community/activity-feed.md): Recent platform activity across ordinary trades, large trades, settlements and newly activated markets, newest first. Filter with `type` (`trades`, `settlements`, `new_markets`); omit it for the combined feed.
- [Leaderboard](https://docs.calibri.io/api-reference/endpoints/community/leaderboard.md): Top members by realised PnL on settled contracts. `username` is a privacy-masked display name (or an explicit display name when set). A member with settled contracts in more than one currency appears once per currency. Filter with `period` (`all`, `24h`, `7d`, `30d`).
- [Asset symbols](https://docs.calibri.io/api-reference/endpoints/assets/asset-symbols.md): Underlying symbols that have recorded tick/candle history (e.g. exchange products feeding candle-direction markets). Read this rather than hard-coding a product list that will go stale.
- [Asset candles](https://docs.calibri.io/api-reference/endpoints/assets/asset-candles.md): The EXCHANGE'S OWN published candles, stored verbatim — not recomputed from sampled ticks. A candle derived from samples has systematically narrower wicks, and a member trading off the chart is paid off the exchange's candle, so the two have to be the same numbers by construction.
- [Asset ticks](https://docs.calibri.io/api-reference/endpoints/assets/asset-ticks.md): The recorded tick stream over a closed range, oldest first — the shape that draws one window. BOTH bounds are required: this endpoint draws a window, and a window has two ends.
- [Asset window](https://docs.calibri.io/api-reference/endpoints/assets/asset-window.md): The exchange's own candle for ONE window — the price to beat, and the price so far. This is the figure a candle-direction market settles on.
- [List browse categories](https://docs.calibri.io/api-reference/endpoints/categories/list-browse-categories.md): The two-level browse tree — Sports > Soccer — with active-event counts. A parent's count includes its children's. Includes categories with no live events; retired ones are omitted. Use a slug with `GET /public/events?category=` or `?subcategory=`.
- [List events](https://docs.calibri.io/api-reference/endpoints/events/list-events.md): The catalogue of events, each with its child markets.
- [Event by slug](https://docs.calibri.io/api-reference/endpoints/events/event-by-slug.md): One event with its markets — the same object as a list element. Falls back to MySQL for older windows that have left the live cache, so bookmarked and historical links keep resolving.
- [Home bundle](https://docs.calibri.io/api-reference/endpoints/events/home-bundle.md): The main event list for the given query, the four fixed rails (`trending`, `ending_soon`, `volume`, `featured` — each `/public/events?sort=<rail>&limit=5&status=active`) and the category tree, in one response. Each part is exactly what its standalone route returns. Takes the same query parameters as…
- [List markets](https://docs.calibri.io/api-reference/endpoints/markets/list-markets.md): Every live market as a flat list, with the same object shape as market detail (pricing fields and CTF ids included). An order — including a signed one — can be built straight from a list response without a per-market follow-up call.
- [Market detail](https://docs.calibri.io/api-reference/endpoints/markets/market-detail.md): One market with pricing fields and CTF ids needed to build an order. Falls back to stored data for settled and voided markets, so historical markets and bookmarked links keep resolving after the engine has dropped them.
- [Recent contracts](https://docs.calibri.io/api-reference/endpoints/market-data/recent-contracts.md): The public trade tape — recently matched YES/NO contracts at a price and volume, newest first. Served for settled markets too (historical tape from storage), not only live engine markets.
- [Depth](https://docs.calibri.io/api-reference/endpoints/market-data/depth.md): Aggregated book as `[price, volume]` pairs per side, best-first, plus a server timestamp. Lighter than the full order-book payload — use this for depth charts; use the order-book endpoint when you need side-tagged levels.
- [K-line (candles)](https://docs.calibri.io/api-reference/endpoints/market-data/k-line-candles.md): OHLC history for the market's own probability (not the underlying asset). Each row is [timestamp, open, high, low, close, volume], timestamp in Unix seconds. Settled markets are still served from storage so historical charts keep loading.
- [Order book](https://docs.calibri.io/api-reference/endpoints/market-data/order-book.md): Aggregated combined book. Because YES + NO = 1.00 there is one book, expressed as YES bids and NO bids. Each level carries side, price and volume ONLY — no order ids, timestamps or owner data are exposed. Use `depth` for the lighter `[price, volume]` chart shape.
- [Ticker](https://docs.calibri.io/api-reference/endpoints/market-data/ticker.md): Rolling 24h ticker for one market — last, open, high, low, volume and change. For a live multi-market dashboard prefer `GET /public/tickers`.
- [All tickers](https://docs.calibri.io/api-reference/endpoints/market-data/all-tickers.md): A snapshot of the rolling 24h ticker for every live market, keyed by market id. Prefer this over N single-market ticker calls when building a multi-market board.
- [List series](https://docs.calibri.io/api-reference/endpoints/series/list-series.md): Every series backing at least one active event, busiest first. Derived from the live event cache — empty shelves never appear. Use a series slug with `GET /public/events?series=` to expand collapsed windows.
- [List tags](https://docs.calibri.io/api-reference/endpoints/tags/list-tags.md): Every tag with at least one ACTIVE event on it, busiest first, with an event count. Derived from the live event cache, so an empty shelf never appears — use for category navigation, not a static taxonomy.
- [All balances](https://docs.calibri.io/api-reference/endpoints/account/all-balances.md): Your balances per currency. `balance_safe` (available) and `locked_safe` (reserved) are the mirror of the USDC in your own on-chain Safe — those are the figures that matter. `redeemable_safe` is winnings the contract owes you that you have not redeemed yet: not spendable until you do. `balance` / `l…
- [Balance by currency](https://docs.calibri.io/api-reference/endpoints/account/balance-by-currency.md): One currency's balance. Same shape as a list element — prefer `balance_safe` / `locked_safe` / `redeemable_safe` over the always-zero operator pool fields.
- [Account limits](https://docs.calibri.io/api-reference/endpoints/account/account-limits.md): Funding-method and global limits for your account. Use before submitting a deposit or withdrawal so you fail client-side instead of on the wire. Pass `with_remaining` to include how much of each limit is left; filter with `currency` and `reference_type`.
- [Read preferences](https://docs.calibri.io/api-reference/endpoints/account/read-preferences.md): Your display preferences. Today: `leaderboard_opt_out` — whether your username appears on the public PnL leaderboard.
- [Update preferences](https://docs.calibri.io/api-reference/endpoints/account/update-preferences.md): Partial update — send only the fields to change. Unknown keys are ignored. Returns the full preferences object after apply.
- [Prediction PnL](https://docs.calibri.io/api-reference/endpoints/account/prediction-pnl.md): Realized PnL from settled contracts, per-market breakdown, and capital in/out. Open positions are not valued here — mark them client-side against the live price feed. `pnl_currency` narrows the response to a single collateral currency.
- [Prediction PnL history](https://docs.calibri.io/api-reference/endpoints/account/prediction-pnl-history.md): Cumulative realized PnL over time, plus cumulative net deposits. Defaults to the last 30 days in daily buckets. Open positions are not valued — a member holding only open positions sees a flat line until their markets settle.
- [Transaction history](https://docs.calibri.io/api-reference/endpoints/account/transaction-history.md): Your ledger across deposits, withdrawals, trades, internal transfers, referral earnings and maker rewards. Filter with `currency`, `type`, and time bounds; paginate with `page` and `limit` — totals land in the `Page` / `Per-Page` / `Total` response headers.
- [Create an account](https://docs.calibri.io/api-reference/endpoints/account/create-an-account.md): Signs up with email and password. The account starts at level 0 in `pending` and receives a confirmation email — confirm before signing in to trade. Optional referral code is accepted at signup.
- [Confirm an email address](https://docs.calibri.io/api-reference/endpoints/account/confirm-an-email-address.md): Consumes the emailed confirmation token, stamps the email as verified, and moves the account to `active` so trading and verification steps can proceed.
- [Resend the confirmation email](https://docs.calibri.io/api-reference/endpoints/account/resend-the-confirmation-email.md): Issues a fresh confirmation link for an account that has not confirmed yet. Fails if the email is already verified.
- [Current account](https://docs.calibri.io/api-reference/endpoints/account/current-account.md): The signed-in member. Narrower than `/resource/users/me`, which additionally returns the verification checklist.
- [Confirm a password reset](https://docs.calibri.io/api-reference/endpoints/account/confirm-a-password-reset.md): Consumes the emailed one-time token and sets the new password. Tokens are single-use and expire; a reused or stale token returns a validation error.
- [Request a password reset](https://docs.calibri.io/api-reference/endpoints/account/request-a-password-reset.md): Emails a reset link. Answers 2xx whether or not the address is registered — a distinguishable response would enumerate accounts.
- [Current account with verification status](https://docs.calibri.io/api-reference/endpoints/account/current-account-with-verification-status.md): The signed-in member plus `kyc`, the eleven-step verification checklist, and the public labels it is computed from. This is the payload a client gates onboarding on.
- [Change password](https://docs.calibri.io/api-reference/endpoints/account/change-password.md): Requires the current password. Only meaningful when `can_change_password` is true — wallet-native and social accounts carry a random password the holder never set.
- [Link a wallet to this account](https://docs.calibri.io/api-reference/endpoints/account/link-a-wallet-to-this-account.md): Attaches a verified EOA to the SIGNED-IN account, so an email or social member can trade non-custodially. Distinct from wallet login, which finds or creates an account for the wallet. Returns 409 if either the account or the wallet is already linked.
- [Cross-chain deposit config](https://docs.calibri.io/api-reference/endpoints/other/cross-chain-deposit-config.md): The chains you can deposit USDC from besides Polygon, each with its minimum, typical time to credit and current fee estimate, plus your deposit address (the same on every chain). USDC sent to that address on a listed chain is bridged to Polygon and credited automatically. Only USDC, and only on the…
- [Cross-chain deposits and withdrawals](https://docs.calibri.io/api-reference/endpoints/other/cross-chain-deposits-and-withdrawals.md): Your cross-chain USDC bridges, newest first — one row per bridge: deposits (`direction: in`, from arrival on the source chain to credit on Polygon) and withdrawals (`direction: out`, from the burn on Polygon to the mint on the destination chain). `direction` filters to one of them. Pagination in the…
- [Accept a cross-chain deposit fee](https://docs.calibri.io/api-reference/endpoints/other/accept-a-cross-chain-deposit-fee.md): When gas is high, a cross-chain deposit waits in `awaiting_consent` with a `quote`: bridging now costs `quote.target_fee`, more than the standard fee. Send that exact amount as `max_fee` to accept it; the deposit is then bridged and you receive the amount minus that fee. If the fee has changed since…
- [Quote a cross-chain withdrawal](https://docs.calibri.io/api-reference/endpoints/other/quote-a-cross-chain-withdrawal.md): Prices a withdrawal of `amount` USDC from your wallet on Polygon to `destination` on another network (`chain_key`, a chain from the bridge config), and returns the wallet transaction to sign for it (`safe_tx`: one batch that pays the fee, approves and burns the rest over Circle CCTP). Sign `safe_tx`…
- [Your contracts](https://docs.calibri.io/api-reference/endpoints/positions/your-contracts.md): Your matched positions. A winning contract settles to the full 1.00 per share — the fee was taken at trade time — but winnings are NOT auto-paid: you redeem them yourself.
- [Contract by id](https://docs.calibri.io/api-reference/endpoints/positions/contract-by-id.md): One matched position, only if you are a party to it. Same object as a list element — useful when following a fill or settlement deep-link.
- [Your positions](https://docs.calibri.io/api-reference/endpoints/positions/your-positions.md): Your net holdings per market and outcome, with the quantity you can sell right now (total less anything already reserved by a resting sell order). Use this to offer a position for sale; use /account/contracts for the trade history behind it.
- [Settled markets](https://docs.calibri.io/api-reference/endpoints/positions/settled-markets.md): Every market you held when it resolved — the position you held, what it cost you (collateral plus fees), and what it paid. A market you lost appears here with a payout of 0, which is why this is not the same as filtering your transactions: a losing position moves no money at settlement and so has no…
- [Referral earnings](https://docs.calibri.io/api-reference/endpoints/rewards/referral-earnings.md): Commission from members you referred, funded from the taker fee they pay on fills. Lifetime totals by currency, split into what is still waiting for the daily payout (`pending_by_currency`) and what has already been paid to your wallet (`paid_by_currency`); the same per referred member; the payout h…
- [Your liquidity rewards](https://docs.calibri.io/api-reference/endpoints/rewards/your-liquidity-rewards.md): Liquidity rewards earned for resting orders, one row per market per UTC day, newest first. Scored daily at 01:00 UTC for the previous day and paid by the daily sweep — `status` moves pending → paying → paid. Filter with `status`; paginate with `page` and `limit` (totals in the `Page` / `Per-Page` /…
- [Pending rewards](https://docs.calibri.io/api-reference/endpoints/rewards/pending-rewards.md): Maker rebates and referral rewards accrued but not yet swept. Rewards accrue the moment a trade fills and are paid on a daily sweep, so this ticks up between payouts. Reaching 0 after a sweep is expected, not an error.
- [CTF wallet](https://docs.calibri.io/api-reference/endpoints/wallet/ctf-wallet.md): The same funding config without the market fields — your Safe (the deposit destination), its owner, and any outstanding setup. For a wallet page that is not tied to a market.
- [Auto-redeem status](https://docs.calibri.io/api-reference/endpoints/wallet/auto-redeem-status.md): Whether resolved winnings are redeemed into your Safe automatically, and the contract to approve (or revoke) to change it.
- [Set auto-redeem](https://docs.calibri.io/api-reference/endpoints/wallet/set-auto-redeem.md): Call after relaying `setApprovalForAll(auto_redeemer_address, enabled)` from your Safe. Returns 409 if the chain does not show that approval yet.
- [CTF config for a market](https://docs.calibri.io/api-reference/endpoints/wallet/ctf-config-for-a-market.md): Everything needed to build and sign an order for one market. Check `safe_status` first: on `setup_required` an order will rest and then fail to settle.
- [List the keys that can sign for your wallet](https://docs.calibri.io/api-reference/endpoints/wallet/list-the-keys-that-can-sign-for-your-wallet.md): Returns the Safe and its current owners. A passkey wallet has exactly one owner (the signer contract derived from your passkey) until you add a signing wallet of your own.
- [Add or remove a signing key on your wallet](https://docs.calibri.io/api-reference/endpoints/wallet/add-or-remove-a-signing-key-on-your-wallet.md): Returns the Safe call authorising another address to sign for your wallet (or removing one, with `remove: true`). Sign it with your passkey and relay it — nothing changes until you do. An added key is a full owner: it can place orders, withdraw, redeem, and remove your passkey. Adding a key you alre…
- [Enrol a passkey wallet](https://docs.calibri.io/api-reference/endpoints/wallet/enrol-a-passkey-wallet.md): Registers the PUBLIC half of a WebAuthn credential and derives the signer contract and Safe address from it. The private half never leaves your authenticator, so Calibri holds no key and cannot recover the account — enrol on a platform whose passkeys sync, or the wallet dies with the device.
- [Redeemable winnings](https://docs.calibri.io/api-reference/endpoints/wallet/redeemable-winnings.md): Settled markets whose self-custody payout you have not yet redeemed, with the wallet config to sign the redeem.
- [Relay a Safe transaction](https://docs.calibri.io/api-reference/endpoints/wallet/relay-a-safe-transaction.md): Gasless relay for any Safe transaction you have signed — setup approvals, redeeming winnings, or moving USDC out. The operator executes and pays the gas; it cannot act without your signature. The Safe must be your own.
- [Session key status](https://docs.calibri.io/api-reference/endpoints/wallet/session-key-status.md): Whether session keys are usable, the highest grant id issued, and the policy TTLs. Returns `enabled: false` rather than an error where the deployment has no session contracts — the caller then falls back to prompting the passkey per order.
- [Authorise a session key](https://docs.calibri.io/api-reference/endpoints/wallet/authorise-a-session-key.md): Returns the Safe calls that authorise a browser-held P-256 key to sign orders. Nothing is authorised until you sign and relay them. `expires_at` is clamped DOWN to policy. The key is never a Safe owner, so withdraw and redeem stay passkey-only.
- [Revoke a session key](https://docs.calibri.io/api-reference/endpoints/wallet/revoke-a-session-key.md): Returns the Safe call to revoke one grant, or every outstanding grant when `key_id` is omitted. Revocation takes effect the moment it is relayed and does kill resting orders that key signed.
- [List currencies](https://docs.calibri.io/api-reference/endpoints/currencies/list-currencies.md): Visible currencies in the registry. Collateral is USDC (6-decimal) on the chain named by `blockchain_key`. Fields describing operator-custodied funding — deposit and withdrawal fees, minimums, enabled flags — are retained for schema stability and do not apply: funding happens on your own Safe.
- [Currency by id](https://docs.calibri.io/api-reference/endpoints/currencies/currency-by-id.md): One currency from the registry, by code (e.g. `usdc`). Same object as a list element; only visible currencies resolve.
- [Reference exchange rates](https://docs.calibri.io/api-reference/endpoints/currencies/reference-exchange-rates.md): USD-based reference rates, refreshed from a price provider on our own clock. DISPLAY ONLY: every market is priced, collateralised and settled in USDC, and an order signature commits to a USDC amount — these decide what number is shown beside it and nothing else. Served from memory, so poll no faster…
- [Health check](https://docs.calibri.io/api-reference/endpoints/health/health-check.md): Liveness probe for the Atlas process. Returns plain-text `200` when the process is up — not a dependency check, and not a trading-engine readiness signal.
- [Models](https://docs.calibri.io/api-reference/models/overview.md): Every response and request shape the API serves, generated from the OpenAPI specification.
- [ActivityItem](https://docs.calibri.io/api-reference/models/activity-item.md)
- [AssetCandlesResponse](https://docs.calibri.io/api-reference/models/asset-candles-response.md)
- [AssetPricesResponse](https://docs.calibri.io/api-reference/models/asset-prices-response.md)
- [AssetSymbolsResponse](https://docs.calibri.io/api-reference/models/asset-symbols-response.md)
- [AssetWindowResponse](https://docs.calibri.io/api-reference/models/asset-window-response.md)
- [BookLevel](https://docs.calibri.io/api-reference/models/book-level.md)
- [BundledOrderBook](https://docs.calibri.io/api-reference/models/bundled-order-book.md): Exactly `GET /public/markets/{id}/order-book`, plus the book's `sequence`.
- [CandlePoint](https://docs.calibri.io/api-reference/models/candle-point.md)
- [CategoryNode](https://docs.calibri.io/api-reference/models/category-node.md)
- [CategoryParentRef](https://docs.calibri.io/api-reference/models/category-parent-ref.md): The top-level node this sits under.
- [CategoryRef](https://docs.calibri.io/api-reference/models/category-ref.md): Subcategory is the browse SUBJECT — the leaf of the two-level category tree, carrying its parent for a breadcrumb.
- [DepthResponse](https://docs.calibri.io/api-reference/models/depth-response.md)
- [ErrorResponse](https://docs.calibri.io/api-reference/models/error-response.md)
- [Event](https://docs.calibri.io/api-reference/models/event.md)
- [EventBundle](https://docs.calibri.io/api-reference/models/event-bundle.md)
- [EventBundleMarket](https://docs.calibri.io/api-reference/models/event-bundle-market.md)
- [FacetCount](https://docs.calibri.io/api-reference/models/facet-count.md)
- [HomeRails](https://docs.calibri.io/api-reference/models/home-rails.md)
- [HomeResponse](https://docs.calibri.io/api-reference/models/home-response.md)
- [LeaderboardEntry](https://docs.calibri.io/api-reference/models/leaderboard-entry.md)
- [LiquidityReward](https://docs.calibri.io/api-reference/models/liquidity-reward.md): LiquidityReward is what the market pays makers for resting orders today (UTC).
- [MarketMeta](https://docs.calibri.io/api-reference/models/market-meta.md)
- [MarketPayload](https://docs.calibri.io/api-reference/models/market-payload.md)
- [MarketTerms](https://docs.calibri.io/api-reference/models/market-terms.md): Terms is what this market resolves against, as structured fields — the conditions `rules` states in prose: kind, strike_type, floor_strike / cap_strike, underlying, measure (instant, granularity, b…
- [MemberOrder](https://docs.calibri.io/api-reference/models/member-order.md)
- [OrderBookResponse](https://docs.calibri.io/api-reference/models/order-book-response.md)
- [OrderCancelResult](https://docs.calibri.io/api-reference/models/order-cancel-result.md)
- [PricePoint](https://docs.calibri.io/api-reference/models/price-point.md)
- [PriceSettlement](https://docs.calibri.io/api-reference/models/price-settlement.md): PriceSettlement is the pair of numbers that decided a price-feed market: the deciding candle's open and close.
- [PriceTarget](https://docs.calibri.io/api-reference/models/price-target.md): PriceTarget is the level this market is judged against, published BEFORE it settles.
- [PublicContract](https://docs.calibri.io/api-reference/models/public-contract.md)
- [SeriesCount](https://docs.calibri.io/api-reference/models/series-count.md)
- [SeriesRef](https://docs.calibri.io/api-reference/models/series-ref.md): Series is the FEED this event came from — Polymarket's `atp` / `mls-2025`, Kalshi's `series_ticker`.
- [SettlementPanel](https://docs.calibri.io/api-reference/models/settlement-panel.md): SettlementPanel is the PUBLISHED, ordered list of authorities this market's outcome may be determined from, resolved from the market's own override or inherited from its series.
- [SettlementSource](https://docs.calibri.io/api-reference/models/settlement-source.md)
- [TagCount](https://docs.calibri.io/api-reference/models/tag-count.md)
- [TagRef](https://docs.calibri.io/api-reference/models/tag-ref.md)
- [TermsMeasure](https://docs.calibri.io/api-reference/models/terms-measure.md)
- [TermsUnderlying](https://docs.calibri.io/api-reference/models/terms-underlying.md)
- [TickerEntry](https://docs.calibri.io/api-reference/models/ticker-entry.md)
- [TickerResponse](https://docs.calibri.io/api-reference/models/ticker-response.md)
- [AutoRedeemRequest](https://docs.calibri.io/api-reference/models/auto-redeem-request.md)
- [BalanceEntity](https://docs.calibri.io/api-reference/models/balance-entity.md)
- [BridgeChainEntity](https://docs.calibri.io/api-reference/models/bridge-chain-entity.md)
- [BridgeConfigEntity](https://docs.calibri.io/api-reference/models/bridge-config-entity.md)
- [BridgeConsentEntity](https://docs.calibri.io/api-reference/models/bridge-consent-entity.md)
- [BridgeConsentRequest](https://docs.calibri.io/api-reference/models/bridge-consent-request.md)
- [BridgePolygonEntity](https://docs.calibri.io/api-reference/models/bridge-polygon-entity.md)
- [BridgeQuoteEntity](https://docs.calibri.io/api-reference/models/bridge-quote-entity.md)
- [BridgeTransferEntity](https://docs.calibri.io/api-reference/models/bridge-transfer-entity.md)
- [BridgeWithdrawQuoteEntity](https://docs.calibri.io/api-reference/models/bridge-withdraw-quote-entity.md)
- [BridgeWithdrawSafeTxEntity](https://docs.calibri.io/api-reference/models/bridge-withdraw-safe-tx-entity.md)
- [ContractEntity](https://docs.calibri.io/api-reference/models/contract-entity.md)
- [CreateOrderRequest](https://docs.calibri.io/api-reference/models/create-order-request.md)
- [CtfAutoRedeemEntity](https://docs.calibri.io/api-reference/models/ctf-auto-redeem-entity.md)
- [CtfConfigEntity](https://docs.calibri.io/api-reference/models/ctf-config-entity.md)
- [CtfRedeemableEntity](https://docs.calibri.io/api-reference/models/ctf-redeemable-entity.md)
- [CtfRedeemableMarketEntity](https://docs.calibri.io/api-reference/models/ctf-redeemable-market-entity.md)
- [CtfWalletBundleEntity](https://docs.calibri.io/api-reference/models/ctf-wallet-bundle-entity.md)
- [CtfWalletEntity](https://docs.calibri.io/api-reference/models/ctf-wallet-entity.md)
- [CurrencyEntity](https://docs.calibri.io/api-reference/models/currency-entity.md)
- [ErrorEntity](https://docs.calibri.io/api-reference/models/error-entity.md)
- [FundingMethodLimitEntity](https://docs.calibri.io/api-reference/models/funding-method-limit-entity.md)
- [GlobalLimitEntity](https://docs.calibri.io/api-reference/models/global-limit-entity.md)
- [LimitsEntity](https://docs.calibri.io/api-reference/models/limits-entity.md)
- [LiquidityRewardEntity](https://docs.calibri.io/api-reference/models/liquidity-reward-entity.md)
- [OrderEntity](https://docs.calibri.io/api-reference/models/order-entity.md)
- [PasskeyEnrolRequest](https://docs.calibri.io/api-reference/models/passkey-enrol-request.md)
- [PendingRewardsEntity](https://docs.calibri.io/api-reference/models/pending-rewards-entity.md)
- [PnlCapitalEntity](https://docs.calibri.io/api-reference/models/pnl-capital-entity.md)
- [PnlEntity](https://docs.calibri.io/api-reference/models/pnl-entity.md)
- [PnlMarketEntity](https://docs.calibri.io/api-reference/models/pnl-market-entity.md)
- [PnlPointEntity](https://docs.calibri.io/api-reference/models/pnl-point-entity.md)
- [PnlRealizedEntity](https://docs.calibri.io/api-reference/models/pnl-realized-entity.md)
- [PositionEntity](https://docs.calibri.io/api-reference/models/position-entity.md)
- [PreferencesEntity](https://docs.calibri.io/api-reference/models/preferences-entity.md)
- [PreferencesUpdateRequest](https://docs.calibri.io/api-reference/models/preferences-update-request.md)
- [RatesEntity](https://docs.calibri.io/api-reference/models/rates-entity.md)
- [ReferralEarningsEntity](https://docs.calibri.io/api-reference/models/referral-earnings-entity.md)
- [ReferredMemberEntity](https://docs.calibri.io/api-reference/models/referred-member-entity.md)
- [RelayRequest](https://docs.calibri.io/api-reference/models/relay-request.md)
- [RelayResultEntity](https://docs.calibri.io/api-reference/models/relay-result-entity.md)
- [SafeOwnerPrepareEntity](https://docs.calibri.io/api-reference/models/safe-owner-prepare-entity.md)
- [SafeOwnerRequest](https://docs.calibri.io/api-reference/models/safe-owner-request.md)
- [SafeOwnersEntity](https://docs.calibri.io/api-reference/models/safe-owners-entity.md)
- [SafeSetupCallEntity](https://docs.calibri.io/api-reference/models/safe-setup-call-entity.md)
- [SafeSetupEntity](https://docs.calibri.io/api-reference/models/safe-setup-entity.md)
- [SessionKeyPrepareEntity](https://docs.calibri.io/api-reference/models/session-key-prepare-entity.md)
- [SessionKeyPrepareRequest](https://docs.calibri.io/api-reference/models/session-key-prepare-request.md)
- [SessionKeyRevokeEntity](https://docs.calibri.io/api-reference/models/session-key-revoke-entity.md)
- [SessionKeyRevokeRequest](https://docs.calibri.io/api-reference/models/session-key-revoke-request.md)
- [SessionKeyStatusEntity](https://docs.calibri.io/api-reference/models/session-key-status-entity.md)
- [SettledMarketEntity](https://docs.calibri.io/api-reference/models/settled-market-entity.md)
- [SignedOrderEntity](https://docs.calibri.io/api-reference/models/signed-order-entity.md)
- [TransactionBridgeEntity](https://docs.calibri.io/api-reference/models/transaction-bridge-entity.md)
- [TransactionEntity](https://docs.calibri.io/api-reference/models/transaction-entity.md)
- [CurrentUserEntity](https://docs.calibri.io/api-reference/models/current-user-entity.md)
- [EmailConfirmRequest](https://docs.calibri.io/api-reference/models/email-confirm-request.md)
- [KycItemEntity](https://docs.calibri.io/api-reference/models/kyc-item-entity.md)
- [KycStatusEntity](https://docs.calibri.io/api-reference/models/kyc-status-entity.md)
- [LabelEntity](https://docs.calibri.io/api-reference/models/label-entity.md)
- [MessageEntity](https://docs.calibri.io/api-reference/models/message-entity.md)
- [PasswordResetConfirmRequest](https://docs.calibri.io/api-reference/models/password-reset-confirm-request.md)
- [PasswordResetRequest](https://docs.calibri.io/api-reference/models/password-reset-request.md)
- [PasswordUpdateRequest](https://docs.calibri.io/api-reference/models/password-update-request.md)
- [PhoneEntity](https://docs.calibri.io/api-reference/models/phone-entity.md)
- [ProfileEntity](https://docs.calibri.io/api-reference/models/profile-entity.md)
- [RegisterRequest](https://docs.calibri.io/api-reference/models/register-request.md)
- [SessionUserEntity](https://docs.calibri.io/api-reference/models/session-user-entity.md)
- [UserEntity](https://docs.calibri.io/api-reference/models/user-entity.md)
- [WalletLinkRequest](https://docs.calibri.io/api-reference/models/wallet-link-request.md)
- [WalletLinkedEntity](https://docs.calibri.io/api-reference/models/wallet-linked-entity.md)

## OpenAPI Specs

- [account](/api-reference/openapi/account.yaml)
- [calibri](/api-reference/openapi/calibri.yaml)
- [identity](/api-reference/openapi/identity.yaml)
- [public](/api-reference/openapi/public.yaml)

## Optional

- [Status](https://status.calibri.io)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.