--- name: aiagentoracle.ai description: aiagentoracle.ai provides single-shot cryptocurrency market data snapshots via a paid API, covering spot prices, historical hourly price series, ranked token lists, top movers, and paginated multi-chain market data. It also exposes a service status endpoint for pre-flight health checks. All data is point-in-time; no streaming or live tick feeds are available. host: aiagentoracle.ai --- # aiagentoracle.ai aiagentoracle.ai is a paid data host targeting AI agents that need structured crypto market data without managing exchange integrations. It covers BTC and ETH individually with dedicated price and history endpoints, and provides broader multi-token coverage through ranked lists, movers, and paginated market snapshots across EVM chains. A confidence score is included on several endpoints, which is useful for agents that need to qualify data quality before acting. The host is narrow in scope: it does not support order execution, wallet operations, or non-EVM chains beyond multi-chain aggregates. ## When to use this host Use aiagentoracle.ai when an agent needs structured, point-in-time crypto market data with confidence scores — particularly for BTC or ETH spot prices, hourly history, ranked token lists, EVM-chain market snapshots, or top movers screening. The service status endpoint makes it suitable for agents that need to gate downstream calls on data freshness. Do not use this host for real-time streaming or live tick data — use a WebSocket-based exchange feed instead. Do not use it for historical OHLCV data beyond recent hourly snapshots — use a dedicated time-series API (e.g. CoinGecko, Messari) for longer lookback windows. Do not use it for non-EVM chains beyond aggregated multi-chain assets, for token search by contract address, or for any trade execution or wallet operations. ## Capabilities ### Service Health Checks whether the AI Agent Oracle service is operational and returns ingestion metrics, uptime, and version before downstream calls are made. - **`fetch-ai-agent-oracle-status`** — Returns the operational status, token count, ingestion metrics, uptime, and version of the AI Agent Oracle service. ### BTC Price Data Provides the current BTC spot price in USD and a recent hourly historical price series for trend analysis or charting. - **`fetch-btc-price`** — Returns the current BTC spot price in USD with a timestamp from the aiagentoracle.ai paid data feed. - **`fetch-btc-price-history`** — Returns hourly BTC price history as a time-ordered array of timestamp/price points, with a snapshot timestamp indicating data freshness. ### ETH Price Data Provides current ETH market data (price, volume, market cap, confidence score) and a recent hourly historical price series for ETH-specific analysis. - **`fetch-eth-token-oracle`** — Returns AI-driven pricing and market data for Ethereum (ETH), including price in USD, 24h volume, market cap, price change, and a confidence score. - **`fetch-eth-token-history`** — Returns hourly historical price data for ETH as a time-series array of timestamp/price points, along with the interval type and an asOf timestamp. ### Broad Token Market Snapshots Returns ranked lists, paginated multi-chain market data, and per-symbol token lookups covering price, volume, market cap, liquidity, and 24h change across EVM chains. - **`fetch-top-crypto-tokens`** — Returns a ranked list of up to 100 cryptocurrency tokens with price, 24h volume, market cap, liquidity, price change percent, confidence score, image URL, and last updated timestamp. - **`fetch-token-market-data`** — Returns current market data for a cryptocurrency token by ticker symbol, including spot price, market cap, 24h volume, liquidity, price change, confidence score, and image URL. - **`fetch-token-market-data`** — Returns current market data for a cryptocurrency token by ticker symbol, including spot price, market cap, 24h volume, liquidity, price change, confidence score, and image URL. ### Market Movers Identifies the top gaining and losing tokens across EVM chains over the past 24 hours, including spot price, volume, and confidence score for each mover. - **`fetch-token-movers`** — Returns up to 10 top gaining and 10 top losing tokens across EVM chains, each with spot price, 24h volume, market cap, liquidity, percent change, and a confidence score. ## Workflows ### Pre-Flight Health Check Before Market Query *Use when an agent needs to verify the oracle service is live and data ingestion is current before consuming any price or market data endpoint.* 1. **`fetch-ai-agent-oracle-status`** — Confirm the service status is operational and lastIngestion is recent; abort or alert if ingestionErrors are elevated. 2. **`fetch-top-crypto-tokens`** — Fetch the ranked token list only after confirming the service is healthy, ensuring the snapshot data is trustworthy. ### BTC Spot-Plus-Trend Analysis *Use when an agent needs both the current BTC price and recent hourly price history to compute short-term momentum or display a price chart with a current marker.* 1. **`fetch-btc-price`** — Retrieve the current BTC spot price in USD as the reference point. 2. **`fetch-btc-price-history`** — Retrieve the hourly historical series to compute price change, trend direction, or populate a chart behind the current price. ### ETH Spot-Plus-Trend Analysis *Use when an agent needs both current ETH market data (including confidence score and market cap) and recent hourly price history for ETH-specific analysis or reporting.* 1. **`fetch-eth-token-oracle`** — Retrieve current ETH price, 24h volume, market cap, and confidence score as the baseline snapshot. 2. **`fetch-eth-token-history`** — Retrieve the hourly historical series to contextualize the current snapshot with recent price movement. ### Mover Deep-Dive *Use when an agent identifies a top-gaining or top-losing token via the movers endpoint and needs full market detail for that specific token before acting or reporting.* 1. **`fetch-token-movers`** — Retrieve the current top gainers and losers list to identify tokens with significant 24h price movement. 2. **`fetch-token-market-data`** — Look up full market data for a specific token symbol surfaced by the movers call to get liquidity, market cap, and confidence score before downstream use. ## Skill reference ### `fetch-btc-price-history` **BTC History Oracle** — Returns hourly BTC price history as a time-ordered array of timestamp/price points, with a snapshot timestamp indicating data freshness. *Use when:* Use when an agent needs a recent series of hourly BTC price data points, such as for charting, trend analysis, or computing short-term price movement over the past ~24 hours. *Not for:* Do not use for real-time streaming BTC prices or live tick data; this is a single-shot historical snapshot. Do not use for tokens other than BTC — this endpoint is BTC-specific. **Returns:** Returns symbol='BTC', interval='hour', an array of ~24 hourly {t, price} points covering roughly the past 24 hours, and an asOf timestamp marking snapshot time. **Example:** `GET https://aiagentoracle.ai/api/v1/token/BTC/history` --- ### `fetch-eth-token-history` **ETH Token History** — Returns hourly historical price data for ETH as a time-series array of timestamp/price points, along with the interval type and an asOf timestamp. *Use when:* Use when an agent needs recent historical ETH price data over time, such as for charting, trend analysis, or computing price changes across hourly intervals. *Not for:* Do not use for real-time streaming price feeds or for tokens other than ETH; use a different token history endpoint or a live price feed API instead. **Returns:** Returns symbol='ETH', interval='hour', an asOf timestamp, and a points array of ~24 objects each with an ISO 8601 timestamp 't' and a numeric USD price. **Example:** `GET https://aiagentoracle.ai/api/v1/token/ETH/history` --- ### `fetch-btc-price` **BTC Price Oracle** — Returns the current BTC spot price in USD with a timestamp from the aiagentoracle.ai paid data feed. *Use when:* Use when an agent needs the latest Bitcoin spot price in USD, including the time the price was recorded, for display, calculation, or decision-making purposes. *Not for:* Do not use for historical price data or price series; this is a single-shot current spot quote only. Not suitable for non-BTC assets — use a different endpoint for other token prices. **Returns:** Returns a JSON object with symbol='BTC', a numeric priceUsd, and an asOf ISO 8601 timestamp indicating when the price was last recorded. **Example:** `GET https://aiagentoracle.ai/api/v1/price/BTC` --- ### `fetch-eth-token-oracle` **ETH Token Oracle** — Returns AI-driven pricing and market data for Ethereum (ETH), including price in USD, 24h volume, market cap, price change, and a confidence score. *Use when:* Use when an agent needs current ETH token pricing, market cap, 24h volume, or price change percentage along with a confidence score for the data quality. *Not for:* Do not use for other tokens or chains; this endpoint is specific to ETH. Not suitable for real-time streaming price feeds — this is a single-shot snapshot. **Returns:** Returns a JSON object with ETH's id, symbol, name, chain, priceUsd, volume24h, marketCap, liquidityUsd, priceChange24hPercent, confidenceScore, imageUrl, and lastUpdated timestamp. **Example:** `GET https://aiagentoracle.ai/api/v1/token/ETH` --- ### `fetch-ai-agent-oracle-status` **AI Agent Oracle Status** — Returns the operational status, token count, ingestion metrics, uptime, and version of the AI Agent Oracle service. *Use when:* Use when an agent needs to check whether the AI Agent Oracle service is operational, retrieve the current token count, inspect ingestion error counts, or confirm the running version before making downstream calls. *Not for:* Do not use for real-time streaming health monitoring or alerting pipelines; this is a single-shot status snapshot, not a continuous feed. **Returns:** Returns a JSON object with status='operational', tokenCount, ingestionErrors, uptime in seconds, version string, and lastIngestion ISO timestamp. **Example:** `GET https://aiagentoracle.ai/api/v1/status` --- ### `fetch-top-crypto-tokens` **Top Crypto Tokens** — Returns a ranked list of up to 100 cryptocurrency tokens with price, 24h volume, market cap, liquidity, price change percent, confidence score, image URL, and last updated timestamp. *Use when:* Use when an agent needs a current ranked snapshot of top cryptocurrency tokens by market cap, including spot prices, trading volume, and price change data for display, analysis, or downstream decision-making. *Not for:* Do not use for real-time streaming price feeds or historical price data; this is a single-shot ranked snapshot. Do not use for token search by name or address — this returns only the top-ranked list. **Inputs:** - `limit` (integer) — Number of top tokens to return. Integer between 1 and 100, default 20. **Returns:** Returns a tokens array of ranked token objects (each with id, symbol, name, chain, priceUsd, volume24h, marketCap, liquidityUsd, priceChange24hPercent, confidenceScore, imageUrl, lastUpdated), plus total count and a freshness string. **Example:** `GET https://aiagentoracle.ai/api/v1/tokens/top?limit=10` --- ### `fetch-token-movers` **Token Movers API** — Returns up to 10 top gaining and 10 top losing tokens across EVM chains, each with spot price, 24h volume, market cap, liquidity, percent change, and a confidence score. *Use when:* Use when an agent needs to identify which tokens are experiencing the largest 24-hour price movements (gainers or losers) across EVM-compatible chains, including market data for screening or alerting purposes. *Not for:* Do not use for real-time streaming price feeds or historical price data; this is a single-shot snapshot of current top movers only. **Returns:** Returns gainers and losers arrays (up to 10 each) with per-token id, symbol, name, chain, priceUsd, volume24h, marketCap, liquidityUsd, priceChange24hPercent, confidenceScore, imageUrl, lastUpdated, plus a top-level asOf timestamp. **Example:** `GET https://aiagentoracle.ai/api/v1/tokens/movers` --- ### `fetch-token-market-data` **AI Agent Oracle Tokens** — Returns a paginated list of cryptocurrency token market data including price, volume, market cap, liquidity, 24h price change, confidence score, and freshness timestamp for EVM chains and multi-chain assets. *Use when:* Use when an agent needs a broad market snapshot of token prices, volumes, market caps, or liquidity across EVM chains (e.g. base, ethereum, arbitrum) or multi-chain assets, with optional filtering by liquidity, market cap, or volume thresholds. *Not for:* Do not use for real-time streaming price feeds or single-token deep dives; this endpoint returns paginated batch snapshots, not live tick data. **Inputs:** - `chain` (string) — EVM chain slug to filter results, e.g. 'base', 'ethereum', 'arbitrum'. Omit for multi-chain results. - `limit` (integer) — Page size, integer 1..500. Defaults to 100. - `offset` (integer) — Page offset for pagination, integer >=0. Defaults to 0. - `min_liquidity` (number) — Minimum on-chain pool liquidity in USD (>=0). Filters out tokens below this threshold. - `min_market_cap` (number) — Minimum fully-diluted market cap in USD (>=0). - `min_volume_24h` (number) — Minimum trailing 24h trading volume in USD (>=0). **Returns:** Returns a tokens array with per-token fields (id, symbol, name, chain, priceUsd, volume24h, marketCap, liquidityUsd, priceChange24hPercent, confidenceScore, imageUrl, lastUpdated), a total count integer, and a freshness ISO timestamp. **Example:** `GET https://aiagentoracle.ai/api/v1/tokens?chain=ethereum&limit=50&offset=0&min_market_cap=1000000&min_volume_24h=100000` --- ### `fetch-token-market-data` **Token Market Data API** — Returns current market data for a cryptocurrency token by ticker symbol, including spot price, market cap, 24h volume, liquidity, price change, confidence score, and image URL. *Use when:* Use when an agent needs current price, market cap, volume, or 24h price change for a specific cryptocurrency token identified by its ticker symbol (e.g. ETH, BTC, USDC). *Not for:* Do not use for historical price series or OHLCV data; use a time-series market data API instead. Not suitable for tokens without a known ticker symbol. **Inputs:** - `symbol` (string, required) — Uppercase ticker symbol of the cryptocurrency token to look up, used as a path parameter in the URL. **Returns:** Returns a JSON object with id, symbol, name, chain, priceUsd, marketCap, volume24h, priceChange24hPercent, confidenceScore, imageUrl, and lastUpdated for the requested token. **Example:** `GET https://aiagentoracle.ai/api/v1/token/ETH` ---