Crypto Data & Market Analysis Agent (CryptoMacro)

{
  "protocol": "a2a-inspired/v1",
  "name": "Crypto Data & Market Analysis Agent (CryptoMacro)",
  "version": "1.0.0",
  "description": "Crypto data agent for AI agents: real-time Bitcoin, Ethereum and altcoin prices, funding rates and open interest across Binance/Bybit/OKX/Hyperliquid \u2014 up to 10 coins per call, so a whole watchlist costs one request \u2014 plus Fear & Greed, on-chain data, macro indicators (Fed, CPI, broad dollar index) and AI-synthesized structured market analysis. Funding is liquidity-filtered, not naively averaged. Pay per call with USDC (x402) or prepaid credits.",
  "attribution": "Price, market and derivatives data from CoinGecko (https://www.coingecko.com). Additional sources: OKX, Hyperliquid, Deribit, Bybit, FRED (Federal Reserve Bank of St. Louis), Alternative.me, DeFiLlama, Etherscan, Finnhub.",
  "url": "https://crypto-asistent.com/api/a2a",
  "documentation": "https://crypto-asistent.com/a2a",
  "authentication": {
    "type": "Bearer",
    "header": "Authorization"
  },
  "capabilities": {
    "tools": true,
    "streaming": false,
    "tasks": true
  },
  "endpoints": {
    "register": "/api/a2a/register",
    "query": "/api/a2a/query",
    "analyze": "/api/a2a/analyze",
    "tasks": "/api/a2a/tasks",
    "balance": "/api/a2a/balance",
    "tools": "/api/a2a/tools",
    "usage": "/api/a2a/usage",
    "topup_address": "/api/a2a/topup/address",
    "topup_confirm": "/api/a2a/topup/confirm"
  },
  "mcp": {
    "url": "https://crypto-asistent.com/mcp",
    "transport": "streamable-http",
    "authentication": "none",
    "free_tools": 17,
    "paid_tools": [
      {
        "name": "analyze_market",
        "protocol": "x402",
        "price": "$0.25",
        "currency": "USDC",
        "network": "eip155:8453"
      }
    ]
  },
  "pricing": {
    "currency": "credits",
    "topup_currency": "USDC",
    "topup_chain": "base",
    "credits_per_usdc": 50
  },
  "x402": {
    "network": "eip155:8453",
    "endpoints": {
      "query": "/api/x402/query",
      "analyze": "/api/x402/analyze"
    },
    "prices": {
      "query": "$0.05",
      "analyze": "$0.25"
    },
    "data": [
      {
        "slug": "funding-oi",
        "path": "/api/x402/data/funding-oi",
        "tool": "get_derivatives_aggregate",
        "price": "$0.04",
        "description": "Perpetual funding rate and open interest for up to 10 coins in a single call, across Binance, Bybit, OKX and Hyperliquid. Answers 'where is the leverage right now?' for a whole watchlist at once. Thin venues are excluded: averaging every venue that publishes a rate overstates BTC funding by ~30x, because a near-empty book printing 9% per 8h counts the same as a deep one. Funding comes per 8h and annualized, so 0.0067% reads as 7.3% a year.",
        "tags": [
          "funding-rate",
          "open-interest",
          "perpetuals",
          "derivatives",
          "crypto"
        ]
      },
      {
        "slug": "funding-by-venue",
        "path": "/api/x402/data/funding-by-venue",
        "tool": "get_derivatives",
        "price": "$0.04",
        "description": "Funding rate and open interest for one coin, broken down venue by venue across Binance, Bybit, OKX and Hyperliquid, using each venue's largest-open-interest perpetual. Use it when venue divergence matters: one venue far more positive or negative than the rest is localised positioning, not market consensus \u2014 the setup that precedes a squeeze on that venue alone. Returns per-venue rows plus average funding, total open interest and the spread.",
        "tags": [
          "funding-rate",
          "derivatives",
          "perpetuals",
          "open-interest",
          "bitcoin"
        ]
      },
      {
        "slug": "brief",
        "path": "/api/x402/data/brief",
        "tool": "get_market_brief",
        "price": "$0.05",
        "description": "The answer, not the inputs. One call returns a stance for the coin \u2014 risk-on, risk-off, fragile or neutral \u2014 built from funding and open interest percentiles, sentiment, options implied volatility, the macro regime and what it costs to execute at your size. Every driver comes back with its number and its reading, plus the conditions that would invalidate the call. The rules are deterministic: the same market gives the same verdict.",
        "tags": [
          "market-intelligence",
          "signals",
          "analysis",
          "trading",
          "crypto"
        ]
      },
      {
        "slug": "orderbook-depth",
        "path": "/api/x402/data/orderbook-depth",
        "tool": "get_execution_cost",
        "price": "$0.04",
        "description": "What a trade actually costs before it is placed: live order book depth on Bybit and OKX, walked at your size. Give it a notional in dollars and it returns the average fill price, slippage against mid in basis points and dollars, the spread, the depth within 1% of mid, and which venue is cheaper for that exact size \u2014 separately for buying and selling. A size the book cannot absorb is reported as unfilled, never priced by extrapolation.",
        "tags": [
          "order-book",
          "liquidity",
          "slippage",
          "execution",
          "crypto"
        ]
      },
      {
        "slug": "implied-volatility",
        "path": "/api/x402/data/implied-volatility",
        "tool": "get_implied_volatility",
        "price": "$0.04",
        "description": "What the options market expects price to do, not what leverage is doing: the 30-day implied volatility index for BTC and ETH, with its percentile over the last month and the expected move in percent over 1, 7 and 30 days. Funding tells you who is crowded; this tells you how much movement is already priced in \u2014 and whether hedging is cheap or expensive relative to where it has been.",
        "tags": [
          "volatility",
          "options",
          "implied-volatility",
          "derivatives",
          "crypto"
        ]
      },
      {
        "slug": "market-history",
        "path": "/api/x402/data/market-history",
        "tool": "get_market_history",
        "price": "$0.04",
        "description": "Whether the current reading is actually high or low, from a series captured every ~10 minutes: funding, open interest, Fear & Greed and BTC dominance, each as current, median, min, max and percentile over the window. A funding rate of 0.006% means nothing on its own; at the 89th percentile of the last 24 hours it means something. This is the question a snapshot endpoint cannot answer, whoever you buy it from.",
        "tags": [
          "funding-rate",
          "open-interest",
          "market-intelligence",
          "signals",
          "crypto"
        ]
      },
      {
        "slug": "fear-greed",
        "path": "/api/x402/data/fear-greed",
        "tool": "get_fear_greed",
        "price": "$0.04",
        "description": "Crypto Fear & Greed Index: current and previous value with classification, plus recent history. A contrarian input \u2014 extreme fear has historically marked accumulation zones and extreme greed distribution zones \u2014 but it is a filter, never a trigger on its own. Pair it with funding to separate real capitulation from a crowded short.",
        "tags": [
          "fear-and-greed",
          "sentiment",
          "signals",
          "market-intelligence",
          "crypto"
        ]
      },
      {
        "slug": "dominance",
        "path": "/api/x402/data/dominance",
        "tool": "get_market_dominance",
        "price": "$0.04",
        "description": "BTC, ETH and USDT dominance as a share of total crypto market cap \u2014 the regime filter to check before sizing any altcoin position. Rising BTC dominance means capital rotating to relative safety; rising USDT dominance means capital leaving for stablecoins, a broader risk-off. Falling BTC dominance with rising ETH dominance is the classic rotation signal.",
        "tags": [
          "dominance",
          "market-intelligence",
          "signals",
          "bitcoin",
          "ethereum"
        ]
      },
      {
        "slug": "whale-flows",
        "path": "/api/x402/data/whale-flows",
        "tool": "get_eth_whale_flows",
        "price": "$0.04",
        "description": "Large ETH transfers (>100 ETH) to and from known exchange wallets in the last 2 hours. Inflows to exchanges are potential distribution pressure, outflows suggest accumulation or a move to cold storage \u2014 but read them as context, not instruction: a single large transfer is often internal rotation between wallets of the same desk.",
        "tags": [
          "on-chain",
          "ethereum",
          "signals",
          "market-intelligence",
          "crypto"
        ]
      },
      {
        "slug": "macro-rates",
        "path": "/api/x402/data/macro-rates",
        "tool": "get_macro_rates",
        "price": "$0.04",
        "description": "The macro regime that drives crypto, as signals rather than raw levels: the 2s10s yield curve spread with its direction and an inverted flag, Fed funds, 2Y and 10Y yields, CPI year-over-year, the broad dollar index, VIX and M2 \u2014 each with its previous reading, so direction comes free. The slope of the curve, not the level of any single yield, is the liquidity signal: re-steepening out of inversion marks the easing that risk assets price first.",
        "tags": [
          "macro",
          "market-intelligence",
          "research",
          "signals",
          "crypto"
        ]
      },
      {
        "slug": "economic-calendar",
        "path": "/api/x402/data/economic-calendar",
        "tool": "get_economic_calendar",
        "price": "$0.04",
        "description": "Scheduled macro catalysts ahead \u2014 FOMC, CPI, PCE, Non-Farm Payrolls, GDP, Retail Sales \u2014 from the official US release calendar. The dates that decide whether a position should be sized down before the print. Returns the scheduled release, not analyst consensus.",
        "tags": [
          "macro",
          "research",
          "signals",
          "market-intelligence",
          "api"
        ]
      },
      {
        "slug": "prices",
        "path": "/api/x402/data/prices",
        "tool": "get_crypto_market",
        "price": "$0.04",
        "description": "Spot price, market cap, 24h volume and 24h change for any coins by id (bitcoin, ethereum, solana and thousands more), in any quote currency. The reference leg for every other signal here: funding and open interest only mean something next to what price did.",
        "tags": [
          "prices",
          "bitcoin",
          "ethereum",
          "market-data",
          "crypto"
        ]
      },
      {
        "slug": "defi-tvl",
        "path": "/api/x402/data/defi-tvl",
        "tool": "get_defi_overview",
        "price": "$0.04",
        "description": "Total value locked across DeFi, the top chains by TVL, and aggregate stablecoin market cap. Stablecoin supply is the dry powder of the whole market: rising supply with rising TVL is risk appetite expanding, falling supply is capital genuinely leaving crypto rather than rotating inside it.",
        "tags": [
          "defi",
          "on-chain",
          "market-intelligence",
          "research",
          "crypto"
        ]
      },
      {
        "slug": "btc-network",
        "path": "/api/x402/data/btc-network",
        "tool": "get_btc_network",
        "price": "$0.04",
        "description": "Bitcoin network health: hashrate, difficulty, transaction count, estimated volume, miner revenue and the largest recent mempool transactions. A congested mempool carrying large transfers can front-run an exchange flow you will only see in price an hour later.",
        "tags": [
          "bitcoin",
          "on-chain",
          "market-data",
          "research",
          "crypto"
        ]
      },
      {
        "slug": "tradfi-quotes",
        "path": "/api/x402/data/tradfi-quotes",
        "tool": "get_market_quotes",
        "price": "$0.04",
        "description": "S&P 500, gold and Nasdaq 100 quotes as the traditional-market leg of a crypto read. BTC trades as a high-beta risk asset far more often than as digital gold, so equities direction is usually the better correlation to check before blaming a crypto-native cause. Priced as ETFs, so use direction and percent change, not the absolute level.",
        "tags": [
          "macro",
          "market-data",
          "research",
          "market-intelligence",
          "crypto"
        ]
      },
      {
        "slug": "address",
        "path": "/api/x402/data/address",
        "tool": "get_eth_address",
        "price": "$0.04",
        "description": "Ethereum address activity: ETH balance plus recent large transfers in and out. Point it at an exchange wallet, a treasury or a wallet a headline just named, and get the movement behind the story rather than the story.",
        "tags": [
          "on-chain",
          "ethereum",
          "research",
          "api",
          "crypto"
        ]
      },
      {
        "slug": "news",
        "path": "/api/x402/data/news",
        "tool": "get_crypto_news",
        "price": "$0.04",
        "description": "Recent crypto headlines for narrative context and catalysts \u2014 the qualitative layer that explains why funding moved when no macro print did. Returns headlines with attribution for summarisation, not article text.",
        "tags": [
          "crypto",
          "research",
          "market-intelligence",
          "signals",
          "api"
        ]
      }
    ]
  }
}