API reference / Supply API (ListingReady)
Supply API (ListingReady)
Total and circulating supply in the format listing sites expect, a Uniswap-format token list and a live listing-readiness report, read on chain at one block.
| Base path | https://feedplumb.com/supply |
|---|---|
| Authentication | None |
| Limits | GET only, CORS-enabled, cached. |
| Health | /supply/health · status page |
GET /supply/{SYM}/total-supply
Plain-text number.
curl -s https://feedplumb.com/supply/PLI/total-supplyGET /supply/PLI/total-supply on this site
GET /supply/{SYM}/circulating-supply
Plain-text number (= total, labelled, until exclusions are confirmed).
curl -s https://feedplumb.com/supply/PLI/circulating-supplyGET /supply/PLI/circulating-supply on this site
GET /supply/{SYM}/supply.json
Supply with block, exclusions and raw values.
curl -s https://feedplumb.com/supply/PLI/supply.jsonExample response
{ "symbol": "PLI", "decimals": 18, "block": 108576364, "totalSupply": "500000000",
"circulatingSupply": "500000000", "excluded": [], … }GET /supply/PLI/supply.json on this site
GET /supply/tokenlist.json
Uniswap-format token list.
curl -s https://feedplumb.com/supply/tokenlist.json | jq '.tokens[0]'GET /supply/tokenlist.json on this site
GET /supply/readiness/{SYM}.json
Live readiness report (pass / warn / fail per check).
curl -s https://feedplumb.com/supply/readiness/PLI.json | jq .summaryGET /supply/readiness/PLI.json on this site
GET /supply/tokens
Configured tokens and labelled exclusions.