FinanceActive

Crypto Price Lookup

Real-time crypto prices, market caps, and 24h % changes via CoinGecko. Pass coins as CoinGecko IDs (['bitcoin','ethereum','solana']) or tickers. Max 25 coins per call. Returns usd, usd_24h_change, usd_market_cap per coin. Add currencies param for multi-currency output (['usd','eur','gbp']).

Endpointx402 Payment Required

POST

https://agentsvc.io/api/v1/proxy/crypto-prices

Price

$0.002 USDC

Latency P99

~500ms

Provider

agentsvc.io

Input Schema

{
  "type": "object",
  "required": [
    "coins"
  ],
  "properties": {
    "coins": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of coin IDs or ticker symbols. Accepts CoinGecko IDs (e.g. 'bitcoin', 'ethereum') or common tickers (e.g. 'BTC', 'ETH', 'SOL'). Max 25 coins per call.",
      "examples": [
        [
          "bitcoin",
          "ethereum"
        ],
        [
          "BTC",
          "ETH",
          "SOL"
        ],
        [
          "bitcoin",
          "BNB",
          "cardano"
        ]
      ]
    },
    "currencies": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": [
        "usd"
      ],
      "description": "Target fiat currencies. Default: ['usd']. Supported: usd, eur, gbp, jpy, chf, aud, cad, btc, eth."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "prices",
    "fetched_at",
    "source"
  ],
  "properties": {
    "prices": {
      "type": "object",
      "description": "Map of coin_id → price data. Each entry contains price(s) in requested currencies, 24h change, and market cap.",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Full coin name (e.g. 'Bitcoin')"
          },
          "symbol": {
            "type": "string",
            "description": "Ticker symbol (e.g. 'BTC')"
          },
          "usd": {
            "type": "number",
            "description": "Price in USD"
          },
          "usd_24h_change": {
            "type": "number",
            "description": "24-hour price change in percent (e.g. 2.35 means +2.35%)"
          },
          "usd_market_cap": {
            "type": "number",
            "description": "Market capitalization in USD"
          }
        }
      }
    },
    "fetched_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp of the data"
    },
    "source": {
      "type": "string",
      "description": "Always: 'CoinGecko'"
    },
    "not_found": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Coin IDs or tickers that could not be resolved"
    }
  },
  "example": {
    "prices": {
      "bitcoin": {
        "name": "Bitcoin",
        "symbol": "BTC",
        "usd": 71923,
        "usd_24h_change": 1.42,
        "usd_market_cap": 1419000000000
      },
      "ethereum": {
        "name": "Ethereum",
        "symbol": "ETH",
        "usd": 2188,
        "usd_24h_change": 0.41,
        "usd_market_cap": 263000000000
      }
    },
    "fetched_at": "2026-04-10T14:00:00.000Z",
    "source": "CoinGecko",
    "not_found": []
  }
}

Code Examples

# Step 1: Call without payment → receive 402 with requirements
curl -X POST "https://agentsvc.io/api/v1/proxy/crypto-prices" \
  -H "Content-Type: application/json" \
  -d '{
  "currencies": [
    "usd"
  ]
}'

# Step 2: Sign payment using x402 SDK, then retry
curl -X POST "https://agentsvc.io/api/v1/proxy/crypto-prices" \
  -H "Content-Type: application/json" \
  -H "X-Payment: x402 usdc base <your-signed-payment>" \
  -d '{
  "currencies": [
    "usd"
  ]
}'

Crypto Price Lookup

Input Schema

Output Schema

Code Examples

Tags

Service Info