x402basequality 0.75

Token price, market cap, volume, and supply metrics for any listed cryptocurrency via x402 micropayment.

Price
per_call
Protocol
x402
Verified
no

What it does

The `/token-details` endpoint is part of Otto AI's x402 Agent Swarm, a suite of 30+ AI-powered services accessible via x402 V2 micropayments. This specific endpoint returns token price, market cap, volume, supply, and basic metrics for any listed cryptocurrency token. It accepts a `symbol` query parameter (e.g., BTC, ETH, SOL) and costs $0.10 per call, payable in USDC on Base, Polygon, or Solana.

The endpoint uses the x402 payment protocol: an initial GET request returns a 402 with a PAYMENT-REQUIRED header containing payment options (EIP-3009 USDC, Permit2 ERC-20, or Solana USDC). After signing and submitting payment via the PAYMENT-SIGNATURE header, the endpoint returns a 200 response with the data plus a signed EIP-712 receipt in the PAYMENT-RESPONSE header. For read-only endpoints like this one, a Sign-In-With-X (SIWX) header grants 1 hour of free repeat access after the initial payment.

Otto AI's swarm is organized into three agent categories: Market Intelligence (including this endpoint), AI Creative Tools, and Trading Execution. The service exposes a full OpenAPI 3.1.0 spec and machine-readable discovery at `/.well-known/x402` and `/llm.txt`. Payment is supported via EVM wallets and Solana wallets, with Permit2 infrastructure available for custom ERC-20 tokens.

Capabilities

token-price-lookupmarket-cap-datavolume-metricssupply-datax402-micropaymentusdc-paymentmulti-chain-paymentsiwx-repeat-accesseip-712-receiptscrypto-market-data

Use cases

  • Agent-driven portfolio analysis that needs current token prices and market caps
  • Automated trading bots requiring real-time token metrics before executing trades
  • Dashboard or alerting systems that aggregate crypto market fundamentals
  • Research workflows comparing token volume, supply, and market cap across assets
  • DeFi applications needing on-demand token pricing data without API key management

Fit

Best for

  • AI agents needing pay-per-call crypto token data without subscriptions
  • Developers building x402-compatible crypto market tools
  • Automated workflows requiring token fundamentals with cryptographic proof of delivery

Not for

  • High-frequency trading requiring sub-second latency (per-call payment overhead)
  • Users who need free or subscription-based bulk historical price data
  • Non-crypto use cases with no USDC wallet available

Quick start

# 1. GET the endpoint to receive the 402 payment challenge
curl https://x402.ottoai.services/token-details?symbol=ETH
# Returns 402 with PAYMENT-REQUIRED header (base64-encoded)
# 2. Decode header, sign USDC payment ($0.10), retry with PAYMENT-SIGNATURE header
# 3. Receive 200 with token data + EIP-712 receipt in PAYMENT-RESPONSE header

Example

Response

{
  "data": {
    "price": 3450.12,
    "symbol": "ETH",
    "marketCap": 415000000000,
    "volume24h": 18500000000,
    "totalSupply": 120250000,
    "circulatingSupply": 120250000
  },
  "status": "success"
}

Endpoint

Transporthttp
Protocolx402
Pay to0x0E84dDEdAaE6A779c462C22a59F301EC31B6b808
CurrencyUSD COIN

Quality

0.75/ 1.00

Full OpenAPI 3.1.0 schema is available with clear parameter definitions and pricing. The endpoint is confirmed live (402 challenge captured). Response body schema is generic (just {status, data}) without detailed field definitions, and the example response is inferred from the endpoint description rather than captured directly.

Warnings

  • Response data schema is generic — actual fields in the 'data' object are not documented in the OpenAPI spec
  • Example response JSON is inferred from the endpoint description, not from an actual captured response
  • The x402 challenge object was captured but appears empty in the probe, which may indicate a probe limitation

Citations

Provenance

Indexed fromx402_bazaar
Enriched2026-04-22 01:02:22Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-21
Last seen2026-04-22

Agent access