> ## 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. # Transaction history > 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. ## OpenAPI ````yaml /api-reference/openapi/calibri.yaml get /api/v2/atlas/account/transactions 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/transactions: get: tags: - Account summary: Transaction history description: >- 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. parameters: - description: Entries per page, 1–1000. Defaults to 50. example: 50 in: query name: limit required: false schema: default: 50 maximum: 1000 minimum: 1 type: integer - description: Page number, from 1. Read `Total` off the response headers. example: 1 in: query name: page required: false schema: default: 1 minimum: 1 type: integer - description: Sort direction on the entry timestamp. Defaults to `desc`. example: desc in: query name: order_by required: false schema: default: desc enum: - asc - desc type: string - description: Upper bound, Unix SECONDS. example: 1725148800 in: query name: time_to required: false schema: type: number - description: >- Lower bound, Unix SECONDS — not milliseconds, and not ISO-8601. A millisecond value lands far in the future and returns nothing rather than erroring. example: 1722470400 in: query name: time_from required: false schema: type: number - description: Find the entry for one on-chain transaction. example: 0x9f2c… in: query name: txid required: false schema: type: string - description: Filter by what produced the entry. example: trade in: query name: type required: false schema: enum: - deposit - withdraw - internal_transfer - trade - referral - referral_reward - maker_reward - lp_reward type: string - description: >- Filter to one asset. Matches either side of the entry, credit or debit. example: usdc in: query name: currency required: false schema: type: string responses: '200': content: application/json: schema: items: $ref: '#/components/schemas/TransactionEntity' type: array description: '' security: - apiKey: [] components: schemas: TransactionEntity: properties: address: description: Address involved, for an on-chain row. example: '0xE1188438C85C98aADFf1a88f97764E607B4978C3' type: string beneficiary_id: description: Custodial funding only — not used on Calibri. example: 12 type: number blockchain_key: example: polygon-mainnet type: string blockchain_name: example: Polygon type: string bridge: $ref: '#/components/schemas/TransactionBridgeEntity' description: >- Deposits and withdrawals that crossed chains: the other side of the bridge. `null` otherwise. change_voucher_amount: description: Voucher flow — not used on Calibri. example: '0' type: string change_voucher_expiry: description: Voucher flow — not used on Calibri. example: '2026-09-01T00:00:00Z' type: string change_voucher_pin: description: Voucher flow — not used on Calibri. example: — type: string created_at: description: ISO-8601. example: '2026-08-07T10:00:00Z' type: string credit_amount: example: '40.00' type: string credit_currency: description: Currency received. example: usdc type: string debit_amount: example: '60.00' type: string debit_currency: description: Currency sent. example: usdc type: string description: description: System-generated summary. example: Bought 100 YES @ 0.60 type: string event_id: example: 45 type: number event_image_url: example: https://cdn.calibri.io/events/btc.png type: string event_title: example: Bitcoin 5-minute type: string executor_address: description: The address that submitted the transaction. example: '0x7830c87c02e56aff27fa8ab1241711331fa86f43' type: string expires_at: description: ISO-8601. example: '2026-08-08T00:00:00Z' type: string fee: description: The taker fee on this fill. example: '0.17' type: string fee_currency: example: usdc type: string from_address: description: >- Deposits: the address that sent it (lowercase). `null` for other entries or when not recorded. example: '0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed' type: - string - 'null' id: example: 90231 type: number initiated_from: description: Where the movement originated. example: web type: string market_id: description: Market this row belongs to. example: '12' type: string market_title: example: Will BTC close above its open? type: string member_description: description: Your own note against this row. example: my hedge type: string on_chain: description: Whether the row corresponds to an on-chain movement. example: true type: boolean order_id: example: 90231 type: string origin_volume: description: Original order volume. example: '100' type: string paid_at: description: When the movement completed. ISO-8601. example: '2026-08-07T10:00:05Z' type: string payment_method_icon_url: description: Payment-provider flow — not used on Calibri. example: — type: string payment_method_name: description: Payment-provider flow — not used on Calibri. example: — type: string payment_method_precision: description: Payment-provider flow — not used on Calibri. example: 2 type: number payment_method_provider: description: Payment-provider flow — not used on Calibri. example: — type: string price: description: Fill price. example: '0.60' type: string quote_currency: description: Settlement currency for the market. example: usdc type: string receiver: example: '0x0DECE7d83f8D47CD8dD8278c0F22c361C58577BD' type: string reference_id: example: 90231 type: number reference_type: description: Related entity type. example: Order type: string sender: example: '0xE1188438C85C98aADFf1a88f97764E607B4978C3' type: string settlement_status: description: On-chain mint badge, where the row came from a contract. example: confirmed type: string side: description: Which leg, for a trade. enum: - 'yes' - 'no' example: 'yes' type: string state: example: active type: string txid: description: Blockchain txid or internal reference. example: 0x9f2c… type: string txid_explorer_url: description: >- Deposits and withdrawals: the full block-explorer URL of `txid`, on the chain that transaction is actually on (for a wallet deposit or withdrawal always Polygon, even when `blockchain_key` names the network a cross-chain withdrawal went to). `null` for other entries, or when there is no txid or explorer. example: https://polygonscan.com/tx/0x9f2c… type: - string - 'null' type: description: One of `trade`, `referral`, `maker_reward`. example: trade type: string updated_at: description: ISO-8601. example: '2026-08-07T10:05:00Z' type: string voucher_pin: description: Voucher flow — not used on Calibri. example: — type: string required: - id - type - created_at - txid_explorer_url - bridge - from_address type: object TransactionBridgeEntity: properties: amount: description: >- USDC that left the source network: what you deposited, or the total a withdrawal took from your wallet (fee included). `null` when unknown. example: '50' type: - string - 'null' direction: description: >- `in`: a deposit bridged from another network. `out`: a withdrawal delivered to one. example: out type: string fee: description: >- Our bridge fee in USDC. `null` when there was none or it is not known yet. example: '3' type: - string - 'null' other_chain_key: description: 'The other network: a deposit''s source, a withdrawal''s destination.' example: ethereum type: - string - 'null' other_chain_name: example: Ethereum type: - string - 'null' other_from_address: description: >- A deposit: the address that sent it on the source network (the first sender when several transfers were bridged together). `null` for a withdrawal, or until known. example: '0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed' type: - string - 'null' other_tx_explorer_url: description: Block-explorer URL of `other_tx_hash`, or `null`. example: https://etherscan.io/tx/0x4be1… type: - string - 'null' other_tx_hash: description: >- A deposit: the transaction that sent it on the source network. A withdrawal: the transaction that delivered it (`null` until delivered). example: 0x4be1… type: - string - 'null' received: description: USDC that arrived on the other side. `null` until it has. example: '46.99' type: - string - 'null' state: description: Where the bridge is (see the bridge transfers list for the states). example: completed type: string required: - direction - other_chain_key - other_chain_name - other_tx_hash - other_tx_explorer_url - other_from_address - amount - fee - received - state 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.