# CargoX Relayer

> Community site for the CargoX ecosystem: a live tracker of the CargoX document network on Polygon, CXO token price, burns, buybacks and DEX trades, plus managed CargoX relayers. The public pages fill their numbers with JavaScript, so if you cannot run JS, read the JSON endpoints below instead — they are what the pages use. Each page also carries a schema.org Dataset (JSON-LD) in its <head> with the current headline numbers.

All times and dates are UTC. Dates are `YYYY-MM-DD`. The public API needs no key; it is rate-limited to 120 requests per minute per IP and most responses are cached for 30–60 s, so polling faster than once a minute gains nothing.

## Pages

- [Home](https://cargoxrelayer.com/): headline network and CXO stats, relayer plans
- [Network tracker](https://cargoxrelayer.com/tracker): documents per day / week / month / year, today vs last year, records, pace, compare days, burns, buybacks, CXO supply
- [CXO trades](https://cargoxrelayer.com/trades): DEX buys vs sells on Polygon and Ethereum, whale prints, top buyers and sellers, live trade feed
- [Protocol](https://cargoxrelayer.com/protocol): how CargoX document relaying works
- [CXO token](https://cargoxrelayer.com/cxo-token): token overview
- [Guide](https://cargoxrelayer.com/guide): how to run a relayer with us

## Network and CXO (JSON)

- [Headline stats](https://cargoxrelayer.com/api/tracker): documents today and in total, CXO price, 24 h change, market cap, 24 h buybacks (USD), lifetime CXO burned, active relayers (24 h)
- [Documents per day](https://cargoxrelayer.com/api/tracker/history?days=30): `days` 1–9999 (9999 = everything since 2020); new / transfer / burn split where classified
- [Pace and records](https://cargoxrelayer.com/api/tracker/pace?level=day): current period vs a typical one and the record; `level` = day | week | month | year
- [Today vs a base day](https://cargoxrelayer.com/api/tracker/compare): default base is the same weekday a year back; `vs=YYYY-MM-DD` to choose
- [Documents per UTC hour](https://cargoxrelayer.com/api/tracker/hourly?days=30): `days` 1–365
- [Period totals](https://cargoxrelayer.com/api/tracker/extended): today, this week, this month, all time, and the record day, week and month; per [month](https://cargoxrelayer.com/api/tracker/monthly), [year](https://cargoxrelayer.com/api/tracker/yearly) and [weekday](https://cargoxrelayer.com/api/tracker/weekday)
- [CXO price history](https://cargoxrelayer.com/api/tracker/prices?days=30): daily, `days` 1–365; [price chart](https://cargoxrelayer.com/api/tracker/price-chart?days=365) up to 1825 days; [intraday, last 24 h](https://cargoxrelayer.com/api/tracker/price-intraday)
- [CXO supply](https://cargoxrelayer.com/api/tracker/supply)
- [Buybacks](https://cargoxrelayer.com/api/tracker/buybacks?days=30), [recent buybacks](https://cargoxrelayer.com/api/tracker/recent-buybacks?limit=20)
- [Burns](https://cargoxrelayer.com/api/tracker/burns?days=30), [burns per year](https://cargoxrelayer.com/api/tracker/burns/yearly)
- [Relayer count](https://cargoxrelayer.com/api/tracker/relayer-count), [relayer leaderboard](https://cargoxrelayer.com/api/tracker/leaderboard?limit=50)
- [Holidays](https://cargoxrelayer.com/api/tracker/holidays): UAE / Egypt / China public holidays that move document volume; `from`, `to`

## CXO DEX trades (JSON)

Common parameters: `days` (1–365, default 30, rolling) or an explicit `from` + `to` window; `chain` = polygon | ethereum (default both); `limit`.

- [Summary](https://cargoxrelayer.com/api/tracker/trades/summary?days=1): buy / sell USD and CXO, trade counts, net flow, venue breakdown, daily series; also `venue`
- [Recent trades](https://cargoxrelayer.com/api/tracker/trades/recent?hours=8): `hours` for a rolling window, `direction` = buy | sell, `venue`
- [Top buyers](https://cargoxrelayer.com/api/tracker/trades/accumulators?days=30), [top sellers](https://cargoxrelayer.com/api/tracker/trades/distributors?days=30)
- [Whale prints](https://cargoxrelayer.com/api/tracker/trades/whale-prints?days=30): largest single trades
- [Buy / sell series](https://cargoxrelayer.com/api/tracker/trades/flow-series?days=30)
- [Wallet flows](https://cargoxrelayer.com/api/tracker/trades/flows?days=30), [relayer sell pressure](https://cargoxrelayer.com/api/tracker/trades/relayer-pressure?days=30), [Polygon PoS bridge](https://cargoxrelayer.com/api/tracker/trades/bridge?days=30)
- [Last on-chain execution price](https://cargoxrelayer.com/api/tracker/trades/execution-price)
- [Indexer status](https://cargoxrelayer.com/api/tracker/trades/status): whether trade history is being rebuilt (totals may be incomplete meanwhile)

## Live feed

- `wss://cargoxrelayer.com/ws/public-feed`: WebSocket with live document relays and buybacks, as used by the pages for their live counters