Zxo Docs · Developers
Zxo API
A free, open, read-only reference for the pool data that powers Zxo's homepage and dapp — build your own tools on top of it.
- Access
- Free, no API key
- Format
- JSON, read-only
- CORS
- Open to any site
- Endpoints
- One per chain
Ideas
What You Can Build
Everything below is the same data Zxo's own homepage and dapp read directly — there's no separate or restricted API, so anything you build has access to exactly what the official frontend does.
Pool explorers & dashboards
Pull live pool listings, token pairings, and group promos for any chain Zxo supports and display them in your own UI.
Portfolio & watchlist tools
Cross-reference a wallet's holdings against active Zxo pools across chains.
Bots & alerts
Poll for newly added pools or promo changes and notify your community when something launches.
Aggregators
Fold Zxo's pool data into a larger multi-protocol farming or yield dashboard.
Referral integrations
Combine pool data with Zxo's on-chain referral system to build your own referral-aware links or landing pages.
Reference
Pool Data Endpoints
One JSON file per chain, refreshed as pools launch.
Reference
Response Shape
Every endpoint above returns the same structure:
pools-<chainId>.json
JSON
{
"chainId": 369, // numeric chain ID
"chainName": "PulseChain Mainnet",
"updated": "2026-09-16T00:00:00Z", // ISO timestamp
"groupNames": { "1": "New Listings" }, // group id -> label
"groupPromos": { "1": "🚀 Just launched..." }, // group id -> promo text, optional
"pools": [
{
"poolId": 0,
"group": 1, // matches a key in groupNames
"poolAddress": "0x...",
"token0": { "name": "...", "symbol": "...", "address": "0x..." },
"token1": { "name": "...", "symbol": "...", "address": "0x..." },
"rewardToken": { "name": "...", "symbol": "...", "address": "0x..." }
}
]
}
An empty "pools": [] array means that chain has no live pools yet — not an error. Always check the array length before rendering, the same way Zxo's own frontend does.
Notes
Good To Know
- This data is read-only and unauthenticated — no API key, no rate-limit headers to worry about, just plain
fetch(). - For on-chain reads (live APR, staked totals, a specific position's status), you'll want to query the Zxo farming contract directly on each chain rather than this API — this endpoint is for pool listings, not real-time on-chain state.
- Contract addresses and verified source for building direct on-chain integrations are on the Contract Sources page.
Zxo Docs