hedera:testnet
Pay-per-query data with a receipt you don't have to trust us for.
Hedera-native market and network data, sold by the call over the x402 standard. Settles in HBAR, USDC or credits for fractions of a cent — no account, no subscription, no minimum. Every purchase writes an immutable receipt to a public consensus log, so the whole business is auditable without touching this server.
56
queries receipted on consensus
0.45
HBAR revenue
0.111
H402 revenue (auto-split)
1
distinct paying accounts
the gap
x402 settles payments. It does not produce receipts.
When an x402 payment settles, the buyer gets a PAYMENT-RESPONSE header and the seller writes a row in its own database. There is no shared record. A third party cannot audit what was sold, to whom, or at what price — and for machine-to-machine commerce with no human in the loop, that is the part you actually need.
Hedera Consensus Service closes it. Every settled payment is appended to a public topic as an ordered, consensus-timestamped, immutable message for a fixed $0.0001 — cheap enough to receipt a $0.0014 query without distorting the economics.
topic 0.0.9840930
Every figure on this page is recomputed from that topic on each request. Nothing is cached in a database, so what you see is what an independent auditor would derive from HashScan alone.
the split
Revenue sharing with no contract, enforced inside the payment
The credits token carries HTS fractional custom fees, so a cut of every transfer is routed to shareholder accounts by consensus — no splitter contract, no gas, no claim() step, no reentrancy surface.
The fees are assessed net of transfers, charged to the sender on top, so the seller still receives the exact quoted price. And because custom fees are applied by the network at execution, they never appear in the transaction body the buyer signs — which is what keeps this compliant with the facilitator's verification rules.
one credits payment, on chain:
0.0.5865529 -2400 buyer
0.0.9840993 +200 holder 10%
0.0.9840994 +200 holder 10%
0.0.9841120 +2000 seller
seller receives exactly
the quoted price.collectors 0.0.9840993 · 0.0.9840994
catalog
Four endpoints, three ways to pay
| endpoint | HBAR | USDC | H402 | returns |
|---|---|---|---|---|
/api/v1/hbar-spot Live HBAR/USD spot price with 24h change and volume. The cheapest product in the catalog — priced so an agent polling every minute spends under a cent an hour. | 0.01 HBAR | $0.001 | 0.001 H402 | usd, change24hPct, vol24hUsd, marketCapUsd, asOf |
/api/v1/network-pulse Live Hedera network throughput measured off the mirror node: observed TPS over the most recent transaction window, plus HBAR supply figures. | 0.02 HBAR | $0.002 | 0.002 H402 | observedTps, windowSeconds, sampleSize, circulatingHbar, totalHbar, asOf |
/api/v1/token-snapshot Supply and distribution snapshot for any HTS token: total and max supply, decimals, treasury, freeze/kyc posture, and the top holders by balance. params: tokenId=0.0.429274 | 0.03 HBAR | $0.003 | 0.003 H402 | tokenId, name, symbol, decimals, totalSupply, maxSupply, treasury, topHolders[] |
/api/v1/whale-watch Recent large transfers touching an account, ranked by absolute size. Useful for agents that need to react to treasury movements without running their own indexer. params: accountId=0.0.5864587 minHbar?=100 | 0.05 HBAR | $0.005 | 0.005 H402 | accountId, minHbar, movements[] { transactionId, hbar, counterparty, consensusAt, hashscan } |
A single 402 advertises all three assets and the buyer picks whichever it holds. HBAR needs no token association; USDC is Circle-issued; H402 additionally pays shareholders on transfer.
quickstart
Buying is one function call
import { buy } from "hbar402/client";
const { data, receipt } = await buy(
"https://hbar402.okeyamy.xyz/api/v1/network-pulse",
{ accountId: "0.0.1234", privateKey: process.env.HEDERA_KEY!, prefer: "hbar" },
);
console.log(data.observedTps); // 13.27
console.log(receipt.hashscan); // verifiable settlementThe 402 handshake, the partially-signed TransferTransaction and the retry all happen underneath. Note the buyer pays no gas — under the Hedera exact scheme the facilitator is the fee payer and submits the transaction, so the buyer spends exactly the quoted price and nothing else. Full walkthrough in the docs.
live ledger
Most recent settlements
on chain