Data

Market Liquidity

Returns prediction market share trades with post-trade reserve snapshots. Use this to build probability timelines per outcome.

GET

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

Get prediction market trade history with reserve data for probability tracking.

Auth: API Key required

Query Parameters

Param	Type	Description
cursor	string	Cursor from previous response
limit	number	Items per page (default: 20, max: 100)
outcomeId	number	Filter by outcome index

Response

{
  "data": [
    {
      "id": 100,
      "buyer": "0x...",
      "outcomeId": 0,
      "shares": "500000000000000000",
      "usdcSpent": "2500000",
      "tradeType": "buy",
      "newReserve": "10000000000000000000",
      "newTotalReserve": "25000000000000000000",
      "txHash": "0x...",
      "blockNumber": 12345678,
      "timestamp": "2026-03-13T12:00:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "hasMore": true,
    "nextCursor": "99"
  }
}

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();