XDC のオラクルデータと証明
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 API

A 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 soon
  • GET /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"
  }
}

Full sample for Feed safety verdictAPI reference for Feed safety verdict

CGO reserve-report facts

Metered API

On-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"
  ]
}

Full sample for CGO reserve-report factsAPI reference for CGO reserve-report facts

Node health

Coming soon

Masternode: 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 soon
  • GET /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
  }
}

Full sample for Node healthAPI reference for Node health

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

  1. Free 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.
  2. Send your key. Every paid call carries the key in the X-FeedPlumb-Key header.
  3. x402 でリクエストごとに決済(近日提供予定)。 Without payment the API answers HTTP 402 with the payment requirements; your client repeats the request with an X-PAYMENT payload.
  4. Receipt 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.

FAQ

Questions

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.

Docs

Docs

Request access

Open the Workspace to create a key and set a spending limit.