Trade

Read one trade by id

get/trades/{tradeId}

Request

  • Base URL: https://kellian.app/api/v1
  • URL: https://kellian.app/api/v1/trades/{tradeId}
  • Auth: none required

Path parameters

tradeIdstring required

Response

Success

idstring required

Stable identifier for this trade; the shareable coordinate.

chainIdinteger required

Compiled protocol release chain ID (Base 8453).

marketAddressstring required

Checksummed or lowercase 20-byte EVM address (0x + 40 hex).

marketQuestionstring nullable required
marketSlugstring nullable required
settlement'onchain' | 'committed' required

Which engine settles this market's fills. onchain = the market contract holds collateral and outcome tokens, and every fill is its own Base transaction. committed = the venue's commit ledger holds them, a fill is paid the instant it matches, and fills are published to Base in batches as standard ERC-1155 transfers under a chained Merkle root — so a trade is recorded on Base a short time after it happens rather than at the moment it happens. Immutable per market, decided by the market's collateral.

outcomeIndexinteger required

0-indexed outcome this trade is in.

outcomeLabelstring nullable required
direction'buy' | 'sell' required
sharesstring required

Outcome tokens moved, in the market collateral's smallest unit.

priceBpsinteger required

Execution price for this outcome, in basis points of one collateral unit.

occurredAtstring date-time required
settlementState'pending' | 'committed' | 'finalized' required

State of this fill's RECORD on Base — never a claim about whether it was paid, which happens before this field exists on either engine. pending (committed markets only) = paid on the venue ledger and waiting for the next batch, so there is no transaction yet. committed = the transaction carrying it is mined. finalized = that block is final. On onchain markets the value tracks the fill's own transaction and is never pending.

batchNoncestring nullable required
batchTxHashstring nullable required
txHashstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.