API reference
Every public HTTP API on https://feedplumb.com. Admin and internal write routes are not public.
| API | Base path | Auth | Health |
|---|---|---|---|
| Feeds API | /api | None | /api/summary.json |
| EventHook API | /notify | Per-client key in x-api-key (nk_…). Keys are issued per client at launch; each client sees only its own subscriptions. | /notify/health |
| DataQuery API | /data | x-api-key: <key> (or Authorization: Bearer <key>) | /data/health |
| RouteQuote API | /route | Venues and health: none. Quotes: a DataQuery key (billed from the same credits). | /route/health |
| AttestHub API | /attest | None for reads | /attest/health |
| NodeAlert status API | /nodewatch | None | /nodewatch/status.json |
| FeedHealth API | /feed-health | Tenant token: ?token=… on the page, x-tenant-token header on the API. | /feed-health/healthz |
| Supply API (ListingReady) | /supply | None | /supply/health |
| MasternodeSetup API | /masternode | None | /masternode/health |
| DocAnchor API | /notary | None today (keys and plan limits planned) | /notary/health |
| RewardStatement API | /statements | None | /statements/health |
| MetricsDesk API | /analytics | None | /analytics/health |
| AuditReady verify API | /audit-prep | None | /audit-prep/health |
| AgentGateway MCP endpoint | /mcp | None | POST only |
By API
Feeds API
/apiJSON snapshots refreshed about every 5 minutes: every known Plugin feed on XDC mainnet with price, status, owner and history.
8 endpoints · auth: noneEventHook API
/notifySubscribe to XDC contract events or ERC-20/XRC-20 transfers and receive HMAC-signed HTTPS POSTs after 5 confirmations.
5 endpoints · auth: API keyDataQuery API
/dataPay-per-call access to indexed feed history, token and pool data, using prepaid, off-chain, non-transferable credits.
8 endpoints · auth: API keyRouteQuote API
/routeBest-route DEX quotes on XDC mainnet across XSwap V2/V3, Oku and Curve, from eth_call simulations.
3 endpoints · auth: key for quotesAttestHub API
/attestRead API and explorer for EAS 1.9.0 attestations.
4 endpoints · auth: noneNodeAlert status API
/nodewatchPublic status page and JSON for XDC masternode and Plugin node checks: uptime, signing lag, missed rounds, penalties and upgrade readiness.
2 endpoints · auth: noneFeedHealth API
/feed-healthPrivate, per-tenant feed-health pages and status JSON (white-label).
4 endpoints · auth: tenant tokenSupply API (ListingReady)
/supplyTotal 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.
6 endpoints · auth: noneMasternodeSetup API
/masternodeRead-only pre-flight for an XDC masternode (stake, owner, node address) and a setup-pack generator.
3 endpoints · auth: noneDocAnchor API
/notarySubmit a SHA-256 hash; hashes are batched hourly into one Merkle root anchored on XDC (Apothem testnet first).
4 endpoints · auth: none (keys planned)RewardStatement API
/statementsMonthly XDC masternode reward and penalty statements (CSV or PDF).
2 endpoints · auth: noneMetricsDesk API
/analyticsDaily XDC network metrics (blocks, transactions, active addresses, token activity) indexed from public RPC.
3 endpoints · auth: noneAuditReady verify API
/audit-prepStateless check whether an XDC mainnet contract's source is verified on BlocksScan (and on XDCScan when an Etherscan API key is configured).
1 endpoint · auth: noneAgentGateway MCP endpoint
/mcpModel Context Protocol over Streamable HTTP (stateless, POST only) with read-only tools for Plugin feeds and XDC data.
2 endpoints · auth: none