AgentOracle

active

AgentOracle - Real-time on-chain analytics and tokenized asset market intelligence feed for autonomous AI agents. Every /api/v1/ endpoint is x402-paywalled in USDC; aggregate paid usage reporting is available separately.

AIBasex402 v2exactaiagentoracle.ai ↗︎

Settled via Coinbase.

Transactions · 30d
45
Volume · 30d
$0.45
Unique buyers · 30d
17
Uptime · 30d
92.1%
Latency p50
138ms
Reported calls · 30d
40

Endpoints (29 live)

  • GET /api/v1/tokens/movers — AgentOracle: 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. (0.01 USDC on Base)
  • GET /api/v1/status — AgentOracle: live 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. (0.01 USDC on Base)
  • GET /api/v1/tokens — AgentOracle: 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. (0.01 USDC on Base)
  • GET /api/v1/price/:symbol — AgentOracle: latest spot price for a single token by ticker symbol — minimal payload (`{ symbol, priceUsd, asOf }`) optimised for high-frequency polling agents. Case-insensitive symbol; returns 404 for unknown symbols. (0.01 USDC on Base)
  • GET /api/v1/price/BTC — Returns the latest BTC price via a paid API endpoint. (0.01 USDC on Base)
  • GET /api/v1/price/ETH — Returns the current ETH price for the oracle endpoint. (0.01 USDC on Base)
  • GET /api/v1/token/ETH — Returns AI-driven ETH token insights and pricing data. (0.01 USDC on Base)
  • GET /api/v1/tokens/top — AgentOracle: 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. (0.01 USDC on Base)
  • GET /api/v1/token/ETH/history — Returns historical data for the ETH token. (0.01 USDC on Base)
  • GET /api/v1/token/BTC/history — Returns historical BTC token data and price history via the oracle API. (0.01 USDC on Base)
  • POST /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/Nansen depth. $0.05 USDC via x402. Docs: https://aiagentoracle.ai/docs/counterparty-risk (0.05 USDC on Base)
  • POST /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 index. $0.05 USDC via x402. Docs: https://aiagentoracle.ai/docs/approvals-risk (0.05 USDC on Base)
  • POST /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 + allowanceChecks strengthen evidence; omit sender → REVIEW. $0.25 USDC via x402. Docs: https://aiagentoracle.ai/docs/preflight (0.25 USDC on Base)
  • GET /api/v1/spendability — AgentOracle: use before an x402 purchase to determine whether an asset can pay directly, requires conversion to USDC, is unsupported, or lacks data. Direct spend requires canonical Base USDC identity; no wallet balances or routes are inspected. (0.01 USDC on Base)
  • GET /api/v1/stablecoin/USDC — AgentOracle: use before holding or accepting canonical Base USDC, USDT, or DAI. Assesses peg deviation, liquidity, 24h market context, freshness, caveats, and depeg risk. (0.03 USDC on Base)
  • GET /api/v1/conversion/estimate — AgentOracle: use before choosing a route to estimate an asset conversion from live spot data. Returns source value and output before fees, spread, slippage, gas, routing, or execution effects. Non-executable and not a swap quote. (0.01 USDC on Base)
  • GET /api/v1/stablecoin/best — AgentOracle: use when choosing a Base stablecoin for payment, treasury, or settlement. Ranks canonical USDC, USDT, and DAI using peg deviation, liquidity, freshness, and conservative missing-data penalties. (0.05 USDC on Base)
  • GET /api/v1/settlement/1 — AgentOracle: verify a payment transaction recorded by AgentOracle and check its Base receipt confirmation state. Returns recorded amount, payer, recipient, route, timestamp, and confirmed, pending, reverted, or temporarily unavailable on-chain state. (0.01 USDC on Base)
  • GET /api/v1/price/1 — AgentOracle: latest spot price for a single token by ticker symbol — minimal payload (`{ symbol, priceUsd, asOf }`) optimised for high-frequency polling agents. Case-insensitive symbol; returns 404 for unknown symbols. (0.01 USDC on Base)
  • GET /api/v1/token/1/history — AgentOracle: price history time-series for a single token — array of `{ t, price }` points at hourly or daily intervals. Pass `interval=hour` (returns hourly points over last 1-14 days) or `interval=day` (daily points over last 30-365 days). `limit` defaults to 24, max 200. Ideal for trading bots, charting agents, and backtesting. (0.01 USDC on Base)

+9 more endpoints.

First seen · last seen · last active