x402 data APIs Metered API
Workspace プランで使える XDC データ API
Check a Plugin price feed before you use it, read ComTech Gold (CGO) reserve-report facts, and soon check masternode and Plugin node health. Every answer comes from public XDC mainnet data, with the block it was read at.
The APIs
Two live APIs, one coming soon
近日提供予定:アカウント不要で、ウォレットからリクエストごとにお支払いいただけるようになります。
Feed safety verdict
Metered APIA pass or fail verdict for a Plugin feed, from fixed rules: the feed is fresh, its answer is positive and its last round is complete. Returns the reasons, warnings such as a single-oracle quorum, the oracle setup of the aggregator, and the other proxies for the same pair with the one to prefer. The feed's answer value is not returned.
GET /x402/v1/feed/{address}/verdict Coming soonGET /x402/v1/verdicts?pair=BASE/QUOTE
Sample response (excerpt)
{
"pair": "PLI/USDT",
"verdict": "pass",
"status": "fresh",
"ageS": 554,
"reasons": [],
"warnings": [],
"preferredProxy": "0x2baa1AEfa06D58454c9c06C56436CdD5B7904248",
"listedSourceCount": 4,
"source": {
"chainId": 50,
"block": 108633587,
"blockTimeIso": "2026-10-23T07:40:35.000Z"
}
}
CGO reserve-report facts
Metered APIOn-chain ComTech Gold (CGO) total supply, mints and burns in about the last 24 hours, and the period, link and age of the latest reserve report listed on the issuer's website. No gold price and no valuation. Facts only: not an attestation.
GET /x402/v1/rwa/cgo/reserve-facts
Sample response (excerpt)
{
"token": {
"symbol": "CGO",
"chainId": 50
},
"supply": {
"totalSupply": "24000",
"mintedInWindow": "0",
"burnedInWindow": "0"
},
"latestReport": {
"periodTo": "2025-03-21",
"ageDays": 581
},
"flags": [
"latest_listed_report_period_ended_over_365_days_ago"
]
}
Node health
Coming soonMasternode: XDPoS role (masternode, standby, penalized or unlisted), blocks since it last produced a block, and missed rounds this epoch. Plugin node: the feeds an oracle address serves, its submissions in about the last 3 hours, rounds behind per feed, feeds where other oracles submitted but this node did not, and its XDC gas balance.
GET /x402/v1/masternode/{address}/health Coming soonGET /x402/v1/plugin-node/{address}/health Coming soon
Sample response (excerpt). This endpoint is coming soon.
{
"status": "healthy",
"role": "masternode",
"signing": {
"blocksSinceLastProduced": 39,
"missedRoundsThisEpoch": 0
},
"network": {
"masternodes": 108,
"standby": 255
}
}
Free sample responses, real responses from XDC mainnet: feed verdict sample (JSON), pair verdicts sample (JSON), cgo reserve facts sample (JSON), masternode health sample (JSON), plugin node health sample (JSON).
For everyone
How API access works
- 1Free account, API key and spending limit. FeedPlumb issues an API key with a free account to consumers in the EU and businesses worldwide. Before using x402, you activate pay-per-request on your key, set a monthly spending limit, and (for consumers) request immediate delivery and acknowledge that you lose the right of withdrawal for each request once served. Manage keys in your FeedPlumb Workspace.
- 2Send your key. Every paid call carries the key in the
X-FeedPlumb-Key header. - 3x402 でリクエストごとに決済(近日提供予定)。 Without payment the API answers HTTP 402 with the payment requirements; your client repeats the request with an
X-PAYMENT payload. - 4Receipt or invoice. Every paid call is recorded against your key. Consumers get a receipt, businesses a monthly invoice.
Failed chain reads are not billed. Each key has its own rate limit.
Who can use the x402 APIs?
近日提供予定:XDC ウォレットをお持ちであれば、EU の消費者の方も世界中の事業者の方も、アカウントなしでご利用いただけるようになります。API キーをご希望の場合は、FeedPlumb Workspace で管理できます。
How does paying per request work?
近日提供予定:有料の呼び出しにはそれぞれ x402 を使用します。お支払いがない場合、API は支払い要件とともに HTTP 402 を返し、クライアントが <code>X-PAYMENT</code> ペイロードを付けてリクエストを再送します。消費者のお客様には領収書を、事業者のお客様には月次の請求書を発行します。
Am I billed when a chain read fails?
No. Failed chain reads are not billed. Each key has its own rate limit.
Where does the data come from?
Data is read from public XDC mainnet contracts and RPC, or computed by FeedPlumb, and every answer comes with the block it was read at. The feed verdict does not return the feed's answer value, and the CGO facts contain no gold price and no valuation. Not financial advice.
Request access
Open the Workspace to create a key and set a spending limit.