Data

Market Liquidity

Returns the AMM bets of a prediction market with the reserves after each bet, newest first in chain order. Order-book fills are not in this list: a fill moves no reserve. Use this to build probability timelines per outcome.

GET

/api/v1/markets/{address}/liquidity

Prediction market trade history with reserve data for probability tracking, newest first, cursor paged (default limit 20). Rows carry usdSource beside valueUsdE18; usdcSpent is deprecated (Deprecation and X-Deprecated-Fields headers). Alias: GET /api/v1/markets/{address}/trades.

Auth: API Key required

Query Parameters

Param	Type	Description
cursor	string	Opaque cursor from pagination.nextCursor
limit	number	Items per page (default: 20, max: 100)
outcomeId	number	Filter by outcome index

Response

{
  "data": [
    {
      "id": 100,
      "host": "0x...",
      "buyer": "0x...",
      "outcomeId": 0,
      "shares": "500000000000000000",
      "usdcSpent": "2500000000000000000",
      "tradeType": "buy",
      "newReserve": "10000000000000000000",
      "newTotalReserve": "25000000000000000000",
      "tokensNet": "2462500000000000000",
      "fee": "37500000000000000",
      "inputToken": "0x...",
      "paid": "2500000000000000000",
      "tokensGross": "2500000000000000000",
      "valuePair": "2500000",
      "valueUsdE18": "2500000000000000000",
      "main": "0x...",
      "txHash": "0x...",
      "logIndex": 9,
      "blockNumber": 12345678,
      "timestamp": "2026-03-13T12:00:00.000Z",
      "pairAsset": "0x...",
      "pairDecimals": 6,
      "pairSymbol": "USDG",
      "inputDecimals": 18,
      "probabilityE18": "400000000000000000"
    }
  ],
  "pagination": {
    "limit": 20,
    "hasMore": true,
    "nextCursor": "12345678:9"
  }
}

The numbers above are illustrative, not a fee rate.

Field	Meaning
probabilityE18	The outcome's probability after the bet: newReserve / newTotalReserve, scaled by 1e18.
tokensNet / fee	Market tokens (18 decimals): credited to the pool after the fee, and the fee.
paid / inputToken	What the bet was paid with, raw units of inputToken (inputDecimals; null when unknown). A pair-asset amount only when inputToken is the market's pair asset.
valuePair	The bet's value in raw units of the market's pair asset.
usdcSpent	Deprecated legacy name: USD × 1e18 of the gross payment (it was raw market tokens). Read valueUsdE18 (USD × 1e18, null when unknown).
tradeType	Always buy: the AMM has no sell.

Example Code

// Get prediction market trade/reserve history for probability tracking
const res = await fetch(
  "https://launchonbasis.com/api/v1/markets/0xMarketAddress/liquidity?outcomeId=0&limit=100",
  { headers: { "X-API-Key": "bsk_your_key" } }
);
const { data, pagination } = await res.json();