Read-only Solana RWA / tokenized-equity pool market data for LP screening agents. Coverage: Raydium + Orca.
- Base:
https://hypermodel.xyz - Auth: none (public read)
- No server-side Top-N / strategy caps — callers set filters and truncate client-side.
Canonical copy for agents: /docs/agent-api.md
Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /api/pools | Filter / sort pools (primary) |
| GET | /api/pool-ohlcv | OHLCV for one pool |
| GET | /api/pool-history | Liquidity line for one pool |
| GET | /api/sync-status | Ingest / sync health |
GET /api/pools — query params
| Param | Type | Default | Description |
|---|---|---|---|
| dex | all | raydium | orca | all | DEX filter |
| quote | all | majors | usdc | sol | majors | Quote side |
| poolType | all | concentrated | standard | all | CLMM vs AMM-style |
| whitelist | bool | false | Only xStock-flagged pools |
| search | string | — | Symbol / name / id substring |
| tf | m15 | h1 | h6 | day | week | month | day | Window for vol/fee/apr |
| sort | fees24h | volume24h | tvl | apr24h | priceChange | fees24h | Sort field |
| dir | desc | asc | desc | Sort direction |
| liqMin / liqMax | number | — | Filter by tvl (USD) |
| volMin / volMax | number | — | Filter by windows[tf].volume |
| feeMin / feeMax | number | — | Filter by windows[tf].fees |
| aprMin / aprMax | number | — | Filter by windows[tf].apr |
| ageMinM / ageMaxM | number | — | Pool age in minutes |
| refresh | bool | false | Force cache refresh |
Despite *24h sort names, fee / volume / apr sort and filters follow tf.
Pool object (high-signal fields)
- id, dex, type, feeRate, tvl
- mintA / mintB: address, symbol, name, logoURI, decimals
- volume24h, fees24h, apr24h (day aliases)
- windows.m15|h1|h6|day|week|month: volume, fees, apr, priceMin, priceMax, priceChangePct
- isXStock, xStockSymbol, xStockTrading, raydiumUrl
- openTime, geckoPoolCreatedAt, geckoUpdatedAt
Examples
curl -sS 'https://hypermodel.xyz/api/pools?quote=majors&tf=day&liqMin=50000&feeMin=100&sort=fees24h&dir=desc'
curl -sS 'https://hypermodel.xyz/api/pools?dex=orca&poolType=concentrated&tf=day&liqMin=20000&aprMin=50&sort=apr24h&dir=desc'
curl -sS 'https://hypermodel.xyz/api/pool-ohlcv?id=POOL_ADDRESS&range=1D'
curl -sS 'https://hypermodel.xyz/api/sync-status'
Agent notes
- You own thresholds and result capping — the API returns the full filtered set.
- Loose filters → large JSON; prefer explicit liq/vol/fee/apr mins.
- Read-only: no create-position / rebalance / wallet APIs here.
- Short TF (m15/h1/h6) depends on Gecko sync — check geckoStale / geckoSyncedAt.