Token price, market cap, volume, and supply metrics for any listed cryptocurrency via x402 micropayment.
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
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 headerExample
Response
{
"data": {
"price": 3450.12,
"symbol": "ETH",
"marketCap": 415000000000,
"volume24h": 18500000000,
"totalSupply": 120250000,
"circulatingSupply": 120250000
},
"status": "success"
}Endpoint
Quality
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
- —Token-details endpoint costs $0.10 per callhttps://x402.ottoai.services
- —Returns token price, market cap, volume, supply, and basic metricshttps://x402.ottoai.services
- —Payment accepted in USDC on Base, Polygon, or Solanahttps://x402.ottoai.services
- —SIWX provides 1 hour free repeat access after initial payment for data endpointshttps://x402.ottoai.services
- —Every call returns a signed EIP-712 receipt as proof of service deliveryhttps://x402.ottoai.services
- —OpenAPI version 3.1.0 with 30+ endpoints across 3 agent categorieshttps://x402.ottoai.services