Pagination

All list endpoints use cursor-based pagination. This is more efficient than offset pagination for large datasets and is stable under concurrent writes.

How it works

Every list response includes a pagination object:

{
  "data": [...],
  "pagination": {
    "next_cursor": "MTcxODQwMDAwMDAwMC00Mg==",
    "has_more": true
  }
}

has_more: true means there are more results to fetch
next_cursor is an opaque string — pass it as the cursor query parameter to get the next page
When has_more is false, you have reached the last page and next_cursor is null

Fetching all pages

const client = new Ironflow("if_your_api_key");

// The Page object has built-in next() support
let page = await client.trades("BTC-PERP", { limit: 100 });
const allTrades = [...page.data];

while (page.hasMore) {
  page = await page.next();
  allTrades.push(...page.data);
}

console.log(`Fetched ${allTrades.length} trades`);

async with Ironflow("if_your_api_key") as client:
    page = await client.trades("BTC-PERP", limit=100)
    all_trades = list(page.data)

    while page.has_more:
        page = await page.next()
        all_trades.extend(page.data)

    print(f"Fetched {len(all_trades)} trades")

# Page 1
curl "https://api.ironflow.sh/v1/trades?source=hyperliquid&market=BTC-PERP&limit=100" \
  -H "Authorization: Bearer if_your_api_key"

# Page 2 — use cursor from previous response
curl "https://api.ironflow.sh/v1/trades?source=hyperliquid&market=BTC-PERP&limit=100&cursor=MTcxODQwMDAwMDAwMC00Mg==" \
  -H "Authorization: Bearer if_your_api_key"

Parameters

Parameter	Default	Max
`limit`	100	1000
`cursor`	—	—

Tips

Use from/to to scope your query. Paginating across years of tick data without a time range will be slow. Always specify from and to for large exports.
Cursors are not permanent. Don’t store cursors for later use — they encode a position within a specific query and may expire.

Getting Started

Concepts

Guides

Terminal

SDKs

How it works

Fetching all pages

Parameters

Tips

​How it works

​Fetching all pages

​Parameters

​Tips

How it works

Fetching all pages

Parameters

Tips