HTTP/1.1 402 PAYMENT REQUIRED agent402.base.eth · BASE · SOLANA · POLYGON · ARBITRUM · MONAD · STELLAR · ALGORAND · ROBINHOOD · USDC · USDG
Agent402 / tools / crypto-orderbook

Crypto order book

$0.003 per call · USDC via x402 · GET /api/crypto-orderbook

L2 order-book snapshot for a spot pair: best bid/ask, mid price, spread (absolute + %), and the top N aggregated price levels per side (default 25, max 100). Pairs use BASE-QUOTE format (BTC-USD, ETH-USD, SOL-USDC). Backed by Coinbase Exchange's public market-data API — keyless; coverage is Coinbase-listed markets.

Input

FieldTypeDescription
pair *stringSpot pair as BASE-QUOTE (e.g. BTC-USD, ETH-USD, SOL-USDC)
depthnumberPrice levels per side to return (1-100, default 25)

Example output

{
  "pair": "BTC-USD",
  "time": "2026-07-14T02:40:51Z",
  "sequence": 132601080491,
  "bestBid": 62489.29,
  "bestAsk": 62490.01,
  "midPrice": 62489.65,
  "spread": 0.72,
  "spreadPct": 0.0012,
  "bids": [
    {
      "price": 62489.29,
      "size": 0.81109777,
      "orders": 8
    }
  ],
  "asks": [
    {
      "price": 62490.01,
      "size": 0.5,
      "orders": 3
    }
  ],
  "depth": 1,
  "totalBidLevels": 15653,
  "totalAskLevels": 27473
}

Try it — see the 402 challenge (free)

curl -i "https://agent402.tools/api/crypto-orderbook?pair=BTC-USD"

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/crypto-orderbook?pair=BTC-USD");
Wallet-only. This tool reaches the network/browser/storage, so it is paid in USDC via x402 (no proof-of-work tier).

Related tools

Stablecoin peg monitor

$0.003 · GET /api/stablecoin-peg

Live $1-peg deviation for the top USD stablecoins (USDT, USDC, USDS, DAI, USDe, PYUSD, USDD, TUSD, FDUSD by default, or …

Wallet balance (native + ERC-20)

$0.002 · POST /api/wallet-balance

Look up the native coin balance (ETH/MATIC) plus every ERC-20 holding for a wallet address on Ethereum, Base, Polygon, A…

ERC-20 token metadata

$0.001 · POST /api/token-metadata

Resolve an ERC-20 contract address to its on-chain metadata: symbol, decimals, name, and logo URL where available. Use t…