aiagentoracle.ai
https://aiagentoracle.aiAgentOracle: top N on-chain crypto tokens by market cap. Pass `limit` (1..100, default 20). Same per-token shape as /tokens — price, 24h volume, market cap, liquidity, 24h price change.
Paid verification
How it worksNo sponsored paid call yet.
Pay this endpoint once from your own wallet (Base USDC, up to $1.00) and we call it and record what came back. Your wallet pays the listed recipient directly; Agent Tools never holds funds. Sponsored checks prove delivery; they do not count as demand.
Quality grade
How grading works- ✓ Answers a real HTTP 402 challenge
- ✓ Publishes a /.well-known/x402 descriptor
- ✓ Payment address on record
- ✓ Settlement network declared
- ✓ Price declared
x402 readiness
Readiness is how fully this listing follows its protocol and how it behaved in our probes over 30 days. It is shown for reference and does not move it in search. Search order and leaderboards use the separate quality grade (here A, 80.3/100), which weighs availability, payability and on-chain demand. How the two differ
| Valid payment requirements | 10/10 | Payment requirements carry a payee, a mainnet network and a price. |
| Live 402 challenge | 20/25 | Endpoint reachable; its 402 challenge was seen earlier (219 ms). |
| x402 version | n/a | x402 version not observed yet. |
| Signed descriptor | n/a | No x402 standard defines a signed descriptor. |
| Uptime (30 days) | 15/15 | 32/32 probes succeeded over 30 days (100%). |
| Resource declaration | 10/10 | Declares 18 paid resource(s). |
| Verified identity | 5/10 | Publisher descriptor (/.well-known/x402 or OpenAPI) on record; claim this listing to verify domain control. |
| Freshness + modern flags | 5/5 | seen in a source within 7 days; declares x402. |
| Security declaration | n/a | Payment is the access control for an x402 resource. |
Compared with peers
Against 10,082 reachable x402 APIs in our daily snapshot (2026-11-12 06:46 UTC). Display only; it does not change search order.
- Readiness
- Higher than 75% of peers
- This listing 87 · peer median 78
- Latency
- Faster than 47% of peers
- This listing 219 ms · peer median 205 ms
Where it loses the most points, and how to win them back
- Live 402 challenge −5
— Answer the paid path with a valid 402 challenge.
Now: Endpoint reachable; its 402 challenge was seen earlier (219 ms).
- Verified identity −5
— Claim the listing and prove control of its domain.
Now: Publisher descriptor (/.well-known/x402 or OpenAPI) on record; claim this listing to verify domain control.
Paid endpoints
18 resource(s) advertised by this origin. Each price below is that resource's own x402 price; the headline price is the range across them.
https://aiagentoracle.ai/api/v1/execution/quote
Compares live on-chain Uniswap V3 and KyberSwap Base routes for WETH, USDC, USDT, and DAI by expected output, atomic-unit minimum output, price impact, estimated gas, and net execution price. Results are explicitly indicative and expire after 30 seconds.
https://aiagentoracle.ai/api/v1/preflight
Must-call before Base send/swap/bridge/stake/contract_call: returns decision ALLOW|REVIEW|BLOCK plus riskScore, simulation/allowance evidence, reasons[], and expiresAt. Agents must abort on BLOCK, escalate on REVIEW, and only sign/submit on ALLOW while now < expiresAt. Optional unsigned tx + allowan
https://aiagentoracle.ai/api/v1/approvals/risk
Must-call before Base ERC-20 approve/increaseAllowance: returns ALLOW|REVIEW|BLOCK plus usdAtRisk, unlimited, spenderLabel, reasons[], expiresAt. Abort on BLOCK; escalate on REVIEW; only sign approve on ALLOW while unexpired. v1 uses live eth_call allowance/balance — not full historical approval ind
https://aiagentoracle.ai/api/v1/risk/counterparty
Must-call before Base send/approve/interact with an address: returns ALLOW|REVIEW|BLOCK plus riskScore, labels[], isContract, accountAgeDays, ofacHit, reasons[], expiresAt. Abort on BLOCK; escalate on REVIEW; only proceed on ALLOW while unexpired. v1 = RPC + OFAC + optional GoPlus — not Arkham/Nanse
https://aiagentoracle.ai/api/v1/risk/token/{contract}
Conservative Base token-contract risk assessment from live security and contract market signals.
https://aiagentoracle.ai/api/v1/stablecoin/{symbol}
Health assessment for canonical Base USDC, USDT, or DAI with peg, liquidity, market, freshness, and confidence signals.
https://aiagentoracle.ai/api/v1/stablecoin/best
Ranks supported canonical Base stablecoins using peg deviation, liquidity, freshness, and conservative missing-data penalties.
https://aiagentoracle.ai/api/v1/status
Service-health snapshot — tracked-token count, last ingestion timestamp, ingestion error counter, process uptime, and API version. Use as a cheap heartbeat before issuing larger queries.
https://aiagentoracle.ai/api/v1/tokens
List real-time on-chain crypto tokens sorted by market cap, with chain / min-liquidity / min-24h-volume / min-market-cap filters and limit+offset pagination. Each row includes price, 24h volume, market cap, liquidity, 24h price change, and confidence score.
https://aiagentoracle.ai/api/v1/tokens/top
Top N on-chain crypto tokens by market cap. Pass `limit` (1..100, default 20). Same per-token shape as /tokens.
https://aiagentoracle.ai/api/v1/tokens/movers
Top 10 gainers and top 10 losers by 24h price change percentage across all tracked on-chain tokens. Returns two parallel arrays plus an `asOf` timestamp.
https://aiagentoracle.ai/api/v1/token/{symbol}
Lookup a single on-chain crypto token by ticker symbol (case-insensitive, e.g. ETH, BTC, SOL). Path parameter; returns the full price/volume/liquidity/market-cap snapshot or 404 for unknown symbols.
https://aiagentoracle.ai/api/v1/price/{symbol}
Latest spot price for a single token by ticker symbol. Minimal payload (symbol, priceUsd, asOf) optimised for high-frequency polling agents and dashboards.
https://aiagentoracle.ai/api/v1/token/{symbol}/history
Price history time-series for a token. Returns an array of {t, price} points at hourly (last 1-14 days) or daily (last 30-365 days) intervals. Query params: interval=hour|day, limit=1..200 (default 24). Ideal for trading bots, charting agents, and backtesting.
https://aiagentoracle.ai/api/v1/asset/{symbol}/assessment
Transaction-intelligence assessment for an asset symbol, combining available market and on-chain signals into an agent-readable assessment.
https://aiagentoracle.ai/api/v1/conversion/estimate?from=ETH&to=USDC&amount=0.01
Indicative, non-executable conversion estimate. Excludes fees, spread, slippage, gas, and routing.
https://aiagentoracle.ai/api/v1/spendability?symbol=ETH&amount=0.01&network=eip155:8453&protocol=x402
Checks support for the requested asset, amount, network, and x402 protocol. A direct-spend decision requires canonical Base USDC's contract address. Does not inspect wallet balances or execute payments.
https://aiagentoracle.ai/api/v1/settlement/{txHash}
Verifies settlement details only for x402 payments recorded by AgentOracle.
How to call
curl -sS -i -X GET https://aiagentoracle.ai # expect HTTP 402 Payment Required (about $0.01/call)Listed in
Directories this entry was found in.