> ## Documentation Index > Fetch the complete documentation index at: https://docs.aura.markets/llms.txt > Use this file to discover all available pages before exploring further. # Reconcile one transaction across Alephium and Aura indexing. > Returns authoritative node state and privacy-filtered Aura correlations. Anonymous callers receive public reconciliation. A presented developer key requires transactions:read. A wallet session reveals only correlations owned by that wallet; when a developer key accompanies the session, that key additionally requires account:read. A developer key alone never reveals account data. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/transactions/{txId} openapi: 3.1.0 info: title: Aura API description: >- Public REST API for Aura, prediction markets on Alephium. This API exposes the app read model: markets, live instant order books, orders, fills, vault state, oracle and governance. Non-trading build-tx endpoints return unsigned transactions for the client to sign with its own wallet. Interactive reference: https://docs.aura.markets/api-reference/introduction ## Discovery Built for integrators, not for lazy implementers: - **Faceted lists.** Every list endpoint accepts `?facets=true` and returns category, tag, and status counts in the same response, so a UI can render filter chips without a second request. - **Cursor pagination.** Stable across inserts and fast at depth. Offset paging via `?page=` is still supported for compat. - **Rich filters.** `?q=`, `?category=`, `?tags=`, `?status=`, `?creator=`, and `?minVolume=` on `/v1/markets`. Tag matching is AND, so all listed tags must be present. - **Sortable.** `?sort=created-at|volume|best-bid-yes|recently-traded` with `?order=asc|desc`. Use `/v1/trending` for the composite-score sort. - **Field projection.** `?fields=id,question,bestBidYes` trims the wire weight for thin clients. - **Unified search.** `/v1/search?q=` matches strictly first, then falls back to typo-tolerant matching when nothing hits. The result type is a discriminated union, so adding events or users later is non-breaking. - **Transparent trending.** `/v1/trending` returns the full algorithm and per-market component scores so the ranking is auditable. - **Categories and tags as first-class.** `/v1/categories` and `/v1/tags` enumerate the taxonomy with market counts. ## Authentication Aura uses wallet-bound account sessions delivered as an HttpOnly cookie. Sign in by signing a one-time challenge with your wallet: ``` POST /v1/auth/challenge { "address": "..." } POST /v1/auth/session { "address": "...", "publicKey": "...", "signature": "...", "keyType": "gl-secp256k1" } ``` The `session` call sets the `aura_session` cookie and returns a CSRF token; send it back in the `x-csrf-token` header on every mutating request. Every token is checked against durable revocation state. `POST /v1/auth/logout` revokes the presented cookie or bearer session; cookie callers include the same CSRF header. Reads are accessible anonymously with low IP-based rate limits; write endpoints (`/v1/tx/*`, social writes) require a valid session. ## Rate limits | Tier | Reads (req/min) | Writes (req/min) | |-----------|----------------:|-----------------:| | Anonymous | 60 per IP | 10 per IP | | Signed-in | 600 per wallet | 60 per wallet | Standard `RateLimit-*` response headers are returned on every request (IETF `draft-ietf-httpapi-ratelimit-headers`). ## Write endpoints Aura never returns raw keys, signing grants, or transaction/intent signatures. Embedded-wallet keys are usable only inside the measured enclave. Endpoints under `/v1/tx/*` return an *unsigned* transaction for an independently controlled wallet to sign and submit. Builder trading endpoints require two independent credentials: a scoped developer key identifies and rate-limits the integration, while a user-created restricted trading authorization permits only its bounded place/cancel policy. Aura signs and submits inside custody; the builder receives a receipt, never a reusable signature. A typical on-chain lifecycle flow: 1. `POST /v1/tx/vault/{address}/deposit` → server returns `{ unsignedTx, gasEstimate, ... }`. 2. Wallet signs `unsignedTx`. 3. Wallet submits the signed tx to any Alephium node. version: 0.1.0 license: name: MIT contact: name: Aura url: https://docs.aura.markets servers: - url: / description: this server security: - SessionCookie: [] - SessionBearer: [] - {} tags: - name: Health description: Liveness + version info. - name: Auth description: Wallet account sessions (sign in, sign out). - name: Developer keys description: Create, rotate, revoke, and audit scoped builder identities. - name: Protocol description: Canonical chain, contract, trading, fee, and realtime configuration. - name: Transactions description: >- Reconcile Alephium transaction state with Aura indexing and recovery state. - name: Platform description: Site-wide banner settings and aggregate platform stats. - name: Realtime description: Server-Sent Events stream for live market and account updates. - name: Webhooks description: >- Durable HMAC-signed delivery of public and explicitly authorized private events. - name: Markets description: Browse and look up prediction markets. - name: Categories description: Top-level market taxonomy with counts. - name: Tags description: Free-form market tags with counts. - name: Events description: Linked-market groups (multi-leg events). - name: Search description: Full-text + fuzzy search across markets. - name: Orderbook description: Live order book + recent fills. - name: Trading description: Secure builder order placement, cancellation, and dead-man controls. - name: Trading receipts description: Public keys for verifying sequencer receipts. - name: Prices description: Latest prices and historical price series. - name: Positions description: Open share positions for the signed-in wallet. - name: Funding description: >- Wallet-authorized native funding balances, deposits, history, and withdrawal construction. - name: Parlays description: Parlay pool capacity, leg correlation checks, and clearance. - name: Vault description: AURA token vault. Build unsigned deposit / unlock / withdraw txs. - name: Disputes description: Optimistic oracle disputes. Read-side state and votes. - name: Oracle votes description: Build unsigned oracle txs (submit / dispute / commit / reveal). - name: Voting description: Governance proposals + voting period state. - name: Vote description: Build unsigned governance vote tx. - name: Proposals description: Validate + build market-proposal txs (single-leg, linked, parlay). - name: Rewards description: Liquidity reward programs, per-wallet accruals, and market sponsorships. - name: Earnings description: >- Unified creator, maker, referral, treasury, and builder attribution accounting. - name: Referrals description: Referral summaries and payout history. - name: Users description: Wallet-scoped reads. Profile, positions, orders, parlays. - name: Account actions description: Aggregated "what does this wallet need to do" views. - name: Account description: Watchlist and notification management for the signed-in wallet. - name: Leaderboard description: Top traders by composite score. - name: Account description: Watchlist and notification state for the signed-in wallet. externalDocs: description: Full Aura documentation (guides + interactive API reference) url: https://docs.aura.markets paths: /v1/transactions/{txId}: get: tags: - Transactions summary: Reconcile one transaction across Alephium and Aura indexing. description: >- Returns authoritative node state and privacy-filtered Aura correlations. Anonymous callers receive public reconciliation. A presented developer key requires transactions:read. A wallet session reveals only correlations owned by that wallet; when a developer key accompanies the session, that key additionally requires account:read. A developer key alone never reveals account data. parameters: - schema: type: string in: path name: txId required: true responses: '200': description: Default Response content: application/json: schema: type: object properties: txId: type: string pattern: ^[0-9a-f]{64}$ known: type: boolean operationTypes: type: array items: type: string chain: type: object properties: authority: type: string enum: - alephium mempoolState: type: string enum: - present - absent - not_applicable confirmationState: type: string enum: - not_found - mempooled - confirmed - conflicted scriptExecution: type: string enum: - success - failure - unknown blockHash: anyOf: - type: string - type: 'null' blockHeight: anyOf: - type: string - type: 'null' blockTimestamp: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' txIndex: anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: 'null' confirmations: type: object properties: chain: anyOf: - type: string - type: 'null' fromGroup: anyOf: - type: string - type: 'null' toGroup: anyOf: - type: string - type: 'null' required: - chain - fromGroup - toGroup additionalProperties: false required: - authority - mempoolState - confirmationState - scriptExecution - blockHash - blockHeight - blockTimestamp - txIndex - confirmations additionalProperties: false aura: type: object properties: indexerState: type: string enum: - unseen - observed - inconsistent reorgStatus: type: string enum: - none - conflicted - local_block_mismatch - chain_absent_with_local_record localBlockHashes: type: array items: type: string recoveryStates: type: array items: type: string marketCreation: anyOf: - type: object properties: stage: anyOf: - type: string enum: - created_locally - proposal_pending - deployment_broadcast - deployment_confirmed - registration_pending - registration_confirmed - open - paused - closed - finalizable - disputed - resolved - settlement_pending - claimable - archived - type: 'null' authority: type: string enum: - transaction_reconciliation evidence: type: string enum: - mempool - confirmed_transaction - indexed_market - inconsistent proposalIds: type: array items: type: string marketRowIds: type: array items: type: string marketAddresses: type: array items: type: string observedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ required: - stage - authority - evidence - proposalIds - marketRowIds - marketAddresses - observedAt additionalProperties: false - type: 'null' sequencer: type: object properties: lookup: type: string enum: - available - unavailable authority: type: string enum: - sequencer asOf: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' streamCursor: anyOf: - type: string - type: 'null' found: anyOf: - type: boolean - type: 'null' correlations: maxItems: 250 type: array items: oneOf: - type: object properties: operation: type: string enum: - batch-settlement state: type: string enum: - proposed - submitted - included - executed - final - confirmed_script_failed - mempool_expired - conflicted - rebuild - unwind_eligible - unwound batchId: type: string pattern: ^(0|[1-9][0-9]*)$ retryCount: type: string pattern: ^(0|[1-9][0-9]*)$ matchCount: type: string pattern: ^(0|[1-9][0-9]*)$ matchIds: maxItems: 25 type: array items: type: string pattern: ^(0|[1-9][0-9]*)$ marketIds: maxItems: 25 type: array items: type: string pattern: ^[0-9a-f]{64}$ funding: type: object properties: pendingLegs: type: string pattern: ^(0|[1-9][0-9]*)$ finalLegs: type: string pattern: ^(0|[1-9][0-9]*)$ failedLegs: type: string pattern: ^(0|[1-9][0-9]*)$ required: - pendingLegs - finalLegs - failedLegs additionalProperties: false blockHash: anyOf: - type: string - type: 'null' confirmationDepth: anyOf: - type: string pattern: ^(0|[1-9][0-9]*)$ - type: 'null' onchainBatchSequence: anyOf: - type: string pattern: ^(0|[1-9][0-9]*)$ - type: 'null' gasDeclared: anyOf: - type: string pattern: ^(0|[1-9][0-9]*)$ - type: 'null' createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ lastSeenAt: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' required: - operation - state - batchId - retryCount - matchCount - matchIds - marketIds - funding - blockHash - confirmationDepth - onchainBatchSequence - gasDeclared - createdAt - updatedAt - lastSeenAt additionalProperties: false - type: object properties: operation: type: string enum: - cancellation-relay state: type: string enum: - submitted - confirmed commandCount: type: string pattern: ^(0|[1-9][0-9]*)$ commandKinds: maxItems: 1000 type: array items: type: string enum: - cancel - cancel_all marketIds: maxItems: 1000 type: array items: type: string pattern: ^[0-9a-f]{64}$ firstEscrowedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ confirmedAt: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' required: - operation - state - commandCount - commandKinds - marketIds - firstEscrowedAt - confirmedAt additionalProperties: false - type: object properties: operation: type: string enum: - checkpoint-anchor state: type: string enum: - submitted - confirmed checkpointId: type: string pattern: ^(0|[1-9][0-9]*)$ epoch: type: string pattern: ^(0|[1-9][0-9]*)$ sequence: type: string pattern: ^(0|[1-9][0-9]*)$ eventHash: type: string pattern: ^[0-9a-f]{64}$ createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ required: - operation - state - checkpointId - epoch - sequence - eventHash - createdAt additionalProperties: false - type: object properties: operation: type: string enum: - resolution-observe - resolution-record state: type: string enum: - submitted marketId: type: string pattern: ^[0-9a-f]{64}$ submittedAtMs: type: string pattern: ^(0|[1-9][0-9]*)$ required: - operation - state - marketId - submittedAtMs additionalProperties: false required: - lookup - authority - asOf - streamCursor - found - correlations additionalProperties: false associations: type: array items: type: object properties: source: type: string enum: - main - sequencer - wallet - desk visibility: type: string enum: - public - private operationType: type: string accountAddress: anyOf: - type: string - type: 'null' marketRowId: anyOf: - type: string - type: 'null' marketAddress: anyOf: - type: string - type: 'null' orderIds: type: array items: type: string matchId: anyOf: - type: string - type: 'null' batchId: anyOf: - type: string - type: 'null' claimId: anyOf: - type: string - type: 'null' proposalId: anyOf: - type: string - type: 'null' parlayId: anyOf: - type: string - type: 'null' payoutId: anyOf: - type: string - type: 'null' state: anyOf: - type: string - type: 'null' indexedAt: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' required: - source - visibility - operationType - accountAddress - marketRowId - marketAddress - orderIds - matchId - batchId - claimId - proposalId - parlayId - payoutId - state - indexedAt additionalProperties: false walletCustody: type: object properties: lookup: type: string enum: - not_requested - not_found_or_not_owned - unavailable - available transaction: anyOf: - type: object properties: kind: type: string enum: - deposit - transfer - sweep state: type: string enum: - signing - submitted - confirmed - failed retry: type: object properties: mode: type: string enum: - awaiting_signature - resubmit_exact_bytes - poll_finality - complete - terminal automatic: type: boolean exactUnsignedTransactionPersisted: type: boolean exactSignaturePersisted: type: boolean required: - mode - automatic - exactUnsignedTransactionPersisted - exactSignaturePersisted additionalProperties: false recovery: type: object properties: failureReason: anyOf: - type: string - type: 'null' failureCode: anyOf: - type: string - type: 'null' notificationState: type: string enum: - not_applicable - pending - delivered notificationAttempts: type: integer minimum: 0 maximum: 9007199254740991 nextNotificationAt: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' required: - failureReason - failureCode - notificationState - notificationAttempts - nextNotificationAt additionalProperties: false operation: anyOf: - type: object properties: commitment: type: string pattern: ^[0-9a-f]{64}$ index: type: integer minimum: 0 maximum: 9007199254740991 size: type: integer minimum: 1 maximum: 16 required: - commitment - index - size additionalProperties: false - type: 'null' intentHash: anyOf: - type: string pattern: ^[0-9a-f]{64}$ - type: 'null' amounts: type: object properties: depositBaseUnits: anyOf: - type: string pattern: ^(0|[1-9][0-9]*)$ - type: 'null' attoAlphOutflow: anyOf: - type: string pattern: ^(0|[1-9][0-9]*)$ - type: 'null' tokenOutflows: anyOf: - type: object propertyNames: type: string pattern: ^[0-9a-f]{64}$ additionalProperties: type: string pattern: ^(0|[1-9][0-9]*)$ - type: 'null' required: - depositBaseUnits - attoAlphOutflow - tokenOutflows additionalProperties: false sequencer: oneOf: - type: object properties: lookup: type: string enum: - available authority: type: string enum: - sequencer found: type: boolean asOf: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ streamCursor: type: string correlations: maxItems: 250 type: array items: oneOf: - type: object properties: operation: type: string enum: - batch-settlement state: type: string enum: - proposed - submitted - included - executed - final - confirmed_script_failed - mempool_expired - conflicted - rebuild - unwind_eligible - unwound batchId: type: string pattern: ^(0|[1-9][0-9]*)$ matchIds: maxItems: 250 type: array items: type: string pattern: ^(0|[1-9][0-9]*)$ marketIds: maxItems: 250 type: array items: type: string pattern: ^[0-9a-f]{64}$ blockHash: anyOf: - type: string pattern: ^[0-9a-f]{64}$ - type: 'null' onchainBatchSequence: anyOf: - type: string pattern: ^(0|[1-9][0-9]*)$ - type: 'null' createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ lastSeenAt: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' required: - operation - state - batchId - matchIds - marketIds - blockHash - onchainBatchSequence - createdAt - updatedAt - lastSeenAt additionalProperties: false - type: object properties: operation: type: string enum: - cancellation-relay state: type: string enum: - submitted - confirmed marketIds: maxItems: 250 type: array items: type: string pattern: ^[0-9a-f]{64}$ firstEscrowedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ confirmedAt: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' required: - operation - state - marketIds - firstEscrowedAt - confirmedAt additionalProperties: false - type: object properties: operation: type: string enum: - checkpoint-anchor state: type: string enum: - submitted - confirmed checkpointId: type: string pattern: ^(0|[1-9][0-9]*)$ epoch: type: string pattern: ^(0|[1-9][0-9]*)$ sequence: type: string pattern: ^(0|[1-9][0-9]*)$ eventHash: type: string pattern: ^[0-9a-f]{64}$ createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ required: - operation - state - checkpointId - epoch - sequence - eventHash - createdAt additionalProperties: false - type: object properties: operation: type: string enum: - resolution-observe - resolution-record state: type: string enum: - submitted marketId: type: string pattern: ^[0-9a-f]{64}$ submittedAtMs: type: string pattern: ^(0|[1-9][0-9]*)$ required: - operation - state - marketId - submittedAtMs additionalProperties: false privateAccount: type: object properties: matches: maxItems: 250 type: array items: type: object properties: matchId: type: string pattern: ^(0|[1-9][0-9]*)$ batchId: type: string pattern: ^(0|[1-9][0-9]*)$ batchState: type: string enum: - proposed - submitted - included - executed - final - confirmed_script_failed - mempool_expired - conflicted - rebuild - unwind_eligible - unwound marketId: type: string pattern: ^[0-9a-f]{64}$ orderId: type: string pattern: ^[0-9a-f]{64}$ role: type: string enum: - taker - maker fundingState: type: string enum: - unfunded - pending - final - failed matchState: type: string enum: - committed - batched - settled - unwound required: - matchId - batchId - batchState - marketId - orderId - role - fundingState - matchState additionalProperties: false cancellations: maxItems: 250 type: array items: type: object properties: commandId: type: string pattern: ^[0-9a-f]{64}$ kind: type: string enum: - cancel - cancel_all targetOrderId: anyOf: - type: string pattern: ^[0-9a-f]{64}$ - type: 'null' marketId: anyOf: - type: string pattern: ^[0-9a-f]{64}$ - type: 'null' state: type: string enum: - submitted - confirmed acceptedAtMs: type: string pattern: ^(0|[1-9][0-9]*)$ confirmedAt: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' required: - commandId - kind - targetOrderId - marketId - state - acceptedAtMs - confirmedAt additionalProperties: false required: - matches - cancellations additionalProperties: false required: - lookup - authority - found - asOf - streamCursor - correlations - privateAccount additionalProperties: false - type: object properties: lookup: type: string enum: - unavailable authority: type: string enum: - sequencer found: type: 'null' asOf: type: 'null' streamCursor: type: 'null' correlations: maxItems: 0 type: array items: not: {} privateAccount: type: 'null' required: - lookup - authority - found - asOf - streamCursor - correlations - privateAccount additionalProperties: false createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ required: - kind - state - retry - recovery - operation - intentHash - amounts - sequencer - createdAt - updatedAt additionalProperties: false - type: 'null' required: - lookup - transaction additionalProperties: false required: - indexerState - reorgStatus - localBlockHashes - recoveryStates - marketCreation - sequencer - associations - walletCustody additionalProperties: false lastCheckedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ required: - txId - known - operationTypes - chain - aura - lastCheckedAt additionalProperties: false '400': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string description: Machine-readable error code (snake_case). message: type: string description: Human-readable error message. requestId: type: string description: >- Per-request correlation id. Include it when reporting an error to Aura. details: {} required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false '403': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string description: Machine-readable error code (snake_case). message: type: string description: Human-readable error message. requestId: type: string description: >- Per-request correlation id. Include it when reporting an error to Aura. details: {} required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false '429': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string description: Machine-readable error code (snake_case). message: type: string description: Human-readable error message. requestId: type: string description: >- Per-request correlation id. Include it when reporting an error to Aura. details: {} required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false '500': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string description: Machine-readable error code (snake_case). message: type: string description: Human-readable error message. requestId: type: string description: >- Per-request correlation id. Include it when reporting an error to Aura. details: {} required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false '503': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string description: Machine-readable error code (snake_case). message: type: string description: Human-readable error message. requestId: type: string description: >- Per-request correlation id. Include it when reporting an error to Aura. details: {} required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false security: - {} - DeveloperKey: [] - SessionCookie: [] - SessionBearer: [] - DeveloperKey: [] SessionCookie: [] - DeveloperKey: [] SessionBearer: [] components: securitySchemes: SessionCookie: type: apiKey in: cookie name: aura_session description: >- HttpOnly session cookie set by POST /v1/auth/session. Mutating requests must also send the CSRF token (returned by that call) in the x-csrf-token header. SessionBearer: type: http scheme: bearer bearerFormat: JWT description: >- The same wallet-bound session JWT returned only when POST /v1/auth/session uses issueToken=true. Intended for server-side/scripted clients; cookie CSRF does not apply. DeveloperKey: type: apiKey in: header name: x-aura-developer-key description: >- Builder identity and quota key. It never substitutes for a wallet session or restricted trading authorization and can never sign or custody assets. ````