> ## Documentation Index > Fetch the complete documentation index at: https://docs.calibri.io/llms.txt > Use this file to discover all available pages before exploring further. # Contract by id > 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. ## OpenAPI ````yaml /api-reference/openapi/calibri.yaml get /api/v2/atlas/account/contracts/{id} openapi: 3.1.0 info: title: Calibri API version: 1.0.0 description: >- The Calibri API. Discover markets, read live books, place signed orders, and manage positions and account data. Routed by path prefix to the service that answers it — which is an implementation detail, not something a caller has to reason about. servers: - description: Production url: https://calibri.io security: [] tags: - name: Health description: Service liveness. x-displayName: Health - name: Events description: Discover events and their metadata. x-displayName: Events - name: Markets description: List markets and load market detail for trading. x-displayName: Markets - name: Series description: Recurring event series. x-displayName: Series - name: Tags description: Editorial shelves used to browse the catalogue. x-displayName: Tags - name: Market Data description: Order book, depth, trade tape, tickers, and candles. x-displayName: Market Data - name: Assets description: Underlying asset price history for price-feed markets. x-displayName: Assets - name: Community description: Leaderboard and platform activity. x-displayName: Community - name: Currencies description: Currency registry. x-displayName: Currencies - name: Trade description: Place, list, and cancel orders. x-displayName: Trade - name: Positions description: Your matched contracts. x-displayName: Positions - name: Wallet description: Self-custody Safe, passkey, session keys, and relay. x-displayName: Wallet - name: Rewards description: Maker rebates and referral earnings. x-displayName: Rewards - name: Account description: Balances, ledger, PnL, limits, preferences, and profile. x-displayName: Account - name: Categories description: Categories x-displayName: Categories - name: Other description: Other x-displayName: Other externalDocs: description: '' url: '' paths: /api/v2/atlas/account/contracts/{id}: get: tags: - Positions summary: Contract by id description: >- 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. parameters: - in: path name: id required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ContractEntity' description: '' '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEntity' description: '' security: - apiKey: [] components: schemas: ContractEntity: properties: avg_price: description: Volume-weighted average across fills. example: 0.6 type: number created_at: description: ISO-8601. example: '2026-08-07T10:00:00Z' type: string direction: description: >- Whether you bought or sold `side` on this contract. Always `buy` on a mint. enum: - buy - sell example: buy type: string event_slug: description: The parent event's slug — what a portfolio row links to. example: btc-updown-5m-1730 type: - string - 'null' event_title: example: Bitcoin Up or Down 5m type: - string - 'null' funds_spent: description: Cash paid, on a buy. 0 on a sell. example: 60 type: number id: example: usdc type: number market_id: description: The market this position is in. example: '12' type: string market_title: example: Will BTC close above its open? type: string match_type: description: >- `mint` creates a YES/NO pair from two buys; `transfer` moves an existing token from a seller to a buyer; `merge` redeems a YES and a NO from two sellers. enum: - mint - transfer - merge example: mint type: string outcome_labels: description: >- The market’s YES and NO leg names, in that order. Absent on a market using the Yes/No default. example: - Above $77,500 - Below $77,500 items: type: string type: array price: description: Fill price, a probability in (0,1). example: 0.6 type: number proceeds: description: Cash received before fees, on a sell. 0 on a buy. example: 0 type: number quote_currency: example: usdc type: string settled_at: description: When the market resolved. Null while the contract is open. example: '2026-08-08T00:00:00Z' type: - string - 'null' settlement_status: description: >- The on-chain mint badge: `pending` until confirmed, `reversed` if the market voided. enum: - pending - confirmed - reversed example: confirmed type: - string - 'null' settlement_status_raw: description: The internal state-machine value behind the badge. example: matched type: string side: description: >- The outcome you traded on this contract. On an exit this is the outcome you sold or bought, not the book side. enum: - 'yes' - 'no' example: 'yes' type: string state: description: Lifecycle. A settled contract names the winning side. enum: - active - settled_yes - settled_no - voided example: active type: string taker_fee_amount: description: >- The taker fee charged at trade time. Nothing further is taken at settlement — a winning share pays the full 1.00. example: '0.17' type: string taker_fee_refunded: description: True when the market voided and the fee was returned. example: false type: boolean volume: description: Shares held. example: 100 type: number required: - id - market_id - market_title - event_slug - event_title - quote_currency - side - direction - match_type - price - avg_price - volume - funds_spent - proceeds - taker_fee_amount - taker_fee_refunded - state - created_at type: object ErrorEntity: properties: errors: description: Match on the code, not the HTTP status or the human text. example: - account.custody.deposits_disabled items: type: string type: array required: - errors type: object securitySchemes: apiKey: description: >- HMAC-signed API key. Send X-Auth-Apikey, X-Auth-Nonce and X-Auth-Signature. in: header name: X-Auth-Apikey type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.