Tokens

Trade History

Returns AMM trade history for a token with cursor-based pagination. Trades are ordered newest first.

GET

/api/v1/tokens/{address}/trades

Get trade history for a token.

Auth: API Key required

Query Parameters

Param	Type	Description
cursor	string	Cursor from previous response for next page
limit	number	Items per page (default: 20, max: 100)
type	string	`buy`, `sell`, `leverage_buy`, or `leverage_sell`

Response

{
  "data": [
    {
      "id": 500,
      "type": "buy",
      "amountToken": "1000000000000000000",
      "amountUSDC": "5000000",
      "user": "0x...",
      "price": "0.005",
      "txHash": "0x...",
      "blockNumber": 12345678,
      "timestamp": "2026-03-13T12:00:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "hasMore": true,
    "nextCursor": "499"
  }
}

Example Code

// Get trade history with cursor pagination
const res = await fetch(
  "https://launchonbasis.com/api/v1/tokens/0xTokenAddress/trades?limit=50",
  { headers: { "X-API-Key": "bsk_your_key" } }
);
const { data, pagination } = await res.json();
// pagination = { limit, hasMore, nextCursor }

// Next page:
const page2 = await fetch(
  `https://launchonbasis.com/api/v1/tokens/0xTokenAddress/trades?cursor=${pagination.nextCursor}&limit=50`,
  { headers: { "X-API-Key": "bsk_your_key" } }
);