How do I list pairs?
Use GET /api/v1/pairs. It returns { items, total, limit, offset, freshWindowSeconds, freshCount }.
| Query | Rule |
|---|---|
fresh | 1h, 6h, 24h, or 7d; optional |
kind | canonical, meme, or stock-stock; optional |
symbol | Optional ticker |
limit | Bounded integer |
offset | Non-negative integer |
curl 'https://api.squeeze.plus/api/v1/pairs?fresh=24h&kind=meme&limit=25'Items are FreshPairDto. The list is newest first. It sorts by createdTs, then createdBlock.
| Field | Type | Meaning |
|---|---|---|
id, version | string | Pool ID and v3 or v4 |
stockSymbol, stockAddress | string | The stock side |
otherSymbol, otherAddress | string | The other side |
kind | string | canonical, meme, or stock-stock |
fee | number | Pool fee in parts per million |
createdBlock | number | Block of creation |
createdTs | number or null | Block time; null until read |
liquidityUsd, stockReserve, vol24hUsd | number or null | Value, reserve, volume |
active, hot | boolean | Read state |
stockGapPct | number or null | Last gap for the stock side |
freshWindowSeconds is the window you asked for. freshCount is how many pairs fall inside it.
Sample
Section titled “Sample”A pair with createdTs: null still sorts by block. The app shows time pending. It is not counted in freshCount.