Blockchain IQ

Smarter research for the on-chain economy.

For AI agents & developers

Crypto market data your agent can buy by the call.

Nine data resources, priced per request and paid in USDC over the open x402 standard. No account, no API key, no human in the loop: an unpaid request returns the price, your agent pays, and the data comes back as JSON.

Live on Base · USDC · x402 v2 · $0.002 to $0.25 per call

Open the free catalog →Try the free sample

What is for sale

Nine resources, one price each.

Crypto Coin Price & Market Data

$0.002 per call

GET /api/x402/v1/price/{coinId}

Crypto price lookup: live USD price for one coin by CoinGecko id (bitcoin, ethereum, solana, ripple for XRP and 280+ others), with 24h, 7d and 30d change, market cap, market-cap rank, 24h volume and all-time high. Use when you need to answer what a coin is worth right now or how it has moved. Refreshed every minute. JSON, no API key, no account. $0.002 per call. Blockchain IQ.

  • coinId — CoinGecko coin id, e.g. 'bitcoin'
  • crypto
  • price
  • bitcoin
  • ethereum
  • market-cap

Crypto Market Snapshot - Top 250

$0.02 per call

GET /api/x402/v1/prices

Bulk crypto prices in one call: live USD price, market cap, rank, 24h volume, 24h/7d/30d change and all-time high for the top 250 coins by market cap plus the smaller names we track (280+ coins). Use for screening, ranking, top gainers and losers, portfolio valuation or building a market table without hundreds of single lookups. Refreshed every minute. JSON, no API key. $0.02 per call. Blockchain IQ.

  • crypto
  • prices
  • market-cap
  • top-coins
  • ranking

Crypto Price History - Daily

from $0.01 per call

GET /api/x402/v1/history/{coinId}

Historical crypto prices: daily USD price series for one coin by CoinGecko id (bitcoin, ethereum, solana, ripple for XRP and more), from 1 to 730 days back via ?days=. Use for charts, returns, volatility, drawdown, moving averages and backtests. Returns date and price per day as JSON. No API key. From $0.01 per call, scaling with the range requested and capped at $0.05. Blockchain IQ.

  • coinId — CoinGecko coin id
  • days — 1–730 (default 365)
  • crypto
  • price-history
  • historical-data
  • bitcoin
  • ethereum

Global Crypto Market Overview

$0.02 per call

GET /api/x402/v1/global

Global crypto market snapshot in one call: total crypto market cap, 24h trading volume, 24h market-cap change, Bitcoin dominance, Ethereum dominance and the number of active cryptocurrencies. Use for whole-market context behind any single coin move, risk-on/risk-off checks and market summaries. Not ticker-specific. JSON, no API key. $0.02 per call. Blockchain IQ.

  • crypto
  • market-cap
  • dominance
  • bitcoin
  • market-overview

US Macro Indicators for Crypto

$0.02 per call

GET /api/x402/v1/macro

US macroeconomic indicators in one call: real GDP growth, CPI inflation, core PCE, unemployment rate, nonfarm payrolls, Fed funds rate, 2-year and 10-year Treasury yields, Japan 10-year yield, WTI crude oil, gold and silver. Each with latest value, prior value and as-of date. Use for the macro backdrop to crypto and risk assets. Sourced from FRED and futures data. JSON, no API key. $0.02 per call. Blockchain IQ.

  • macro
  • economy
  • inflation
  • interest-rates
  • commodities

Tokenized Real-World Assets Data

$0.02 per call

GET /api/x402/v1/rwa

Tokenized real-world assets (RWA) market data: total tokenized market cap, breakdown by asset type and the largest tokenized assets with their market caps. Use to size the RWA and tokenization market or compare tokenized products. JSON, no API key. $0.02 per call. Blockchain IQ.

  • rwa
  • tokenization
  • tokenized-treasuries
  • stablecoins
  • crypto

Crypto Sector Indices - List

$0.02 per call

GET /api/x402/v1/indices

List of analyst-curated crypto sector indices and thematic baskets, each with slug, name, description and number of member coins. Use to find which coins belong to a crypto sector or narrative, then fetch one index for its members and prices. JSON, no API key. $0.02 per call. Blockchain IQ.

  • crypto
  • index
  • sectors
  • narratives
  • baskets

Crypto Sector Index - Members

$0.25 per call

GET /api/x402/v1/indices/{slug}

One analyst-curated crypto sector index by slug: its full list of member coins with live USD price, market cap, rank, 24h volume and 24h/7d/30d change for every constituent. Use to analyse a crypto sector or narrative as a basket, compare its members or track sector performance. JSON, no API key. $0.25 per call. Blockchain IQ.

  • slug — index slug, e.g. 'ai-agents'
  • crypto
  • index
  • sector
  • constituents
  • market-data

Crypto Analytics Dashboards

$0.25 per call

GET /api/x402/v1/dashboards/{slug}

Crypto analytics dashboard data with an analyst read on each chart. Pick one by slug: market-overview, on-chain-metrics, defi-tvl-and-yields, stablecoin-story, tokenized-rwas, leverage-and-derivatives, liquidity-and-venues, volatility-and-execution, corporate-treasuries, crypto-fundraising, exploit-losses, xrp-ledger, bitcoin-network, ethereum-network, base-network, arbitrum-network, aptos-network, provenance-network. Every panel as JSON. $0.25 per call. Blockchain IQ.

  • slug — dashboard slug, e.g. 'market-overview'
  • crypto
  • analytics
  • on-chain
  • defi
  • stablecoins

How payment works

HTTP 402, answered with USDC.

The API speaks x402 protocol version 2. Payment is in USDC on Base (eip155:8453). There is nothing to sign up for and no key to request — a wallet holding USDC is the only credential.

  1. Step 1

    Call the resource

    A plain GET, no headers. Every paid URL is listed below and in the free catalog.

  2. Step 2

    Read the 402

    The reply is HTTP 402 with a PAYMENT-REQUIRED header: base64 JSON naming the price, the asset (USDC), the network and the address to pay.

  3. Step 3

    Pay and retry

    Your x402 client signs a USDC payment for that amount and repeats the request with it. Settlement is gasless for the payer.

  4. Step 4

    Get the data

    HTTP 200 with JSON, plus a PAYMENT-RESPONSE header carrying the transaction hash. A 404 or an error is never charged.

Copy-paste example

One paid call with @x402/fetch.

Node 18 or later. The wrapper handles the 402, the payment and the retry; the spend control refuses any single call above the amount you set.

// npm install @x402/fetch @x402/evm viem
import { privateKeyToAccount } from "viem/accounts";
import { wrapFetchWithPayment, x402Client, decodePaymentResponseHeader } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";

// A wallet holding a little USDC on Base. Settlement is gasless for the payer.
const account = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY);

const client = x402Client.fromConfig({
  schemes: [{ network: "eip155:*", client: new ExactEvmScheme(account) }],
  spendControls: { maxAmountPerPayment: 0.3 }, // dollars; refuse anything dearer
});
const payFetch = wrapFetchWithPayment(fetch, client);

// The first request gets HTTP 402 with a PAYMENT-REQUIRED header; the wrapper
// signs a USDC payment for that amount and retries with it.
const res = await payFetch("https://www.blockchainiq.co/api/x402/v1/price/bitcoin");
const { data } = await res.json();
console.log(data);

// Proof of settlement: payer, network and transaction hash.
console.log(decodePaymentResponseHeader(res.headers.get("payment-response")));

Use it from an MCP client

The same catalog, as tools.

blockchainiq-x402-mcp is an MCP server that exposes every resource above as a tool for Claude, Cursor and other MCP clients. The catalog and sample tools are free and work with no wallet. Paid tools are paid by your own wallet, in USDC on Base only, capped at $0.30 per call unless you change it. The private key stays on your machine.

npx -y blockchainiq-x402-mcp

Or add it to your client’s MCP configuration (Claude Desktop shown; leave out the env block to use only the free tools):

{
  "mcpServers": {
    "blockchainiq": {
      "command": "npx",
      "args": ["-y", "blockchainiq-x402-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Use a dedicated wallet with a small balance, never a main wallet. Setup for other clients, every option and the source are on the npm page.

Free, no payment

Catalog

Every resource, price and response schema as JSON — read this first.

GET /api/x402/v1

Well-known alias

The same catalog at the conventional location an agent probes first.

GET /.well-known/x402

Sample

Bitcoin’s current market data, unpaid, in the same envelope as a paid call — test your parsing before spending anything.

GET /api/x402/v1/sample

Plain-text summary for language models: /llms.txt. OpenAPI 3.1 document with every operation, its parameters and its price: /openapi.json. Subscriptions for people are on the pricing page.

Market data, not investment advice

Every response is market data and analysis, not investment advice, and carries that statement in its JSON envelope alongside the source. Use of the API is covered by our terms. Questions: team@blockchainiq.co.