# Joe Market Data – Token Details

> Joe Market Data – Token Details is a paid API for AI agents from joe-market-data.marnick-yezo.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns current price, market cap, and metadata for a cryptocurrency token by symbol, sourced from CoinGecko.

## Facts

- Endpoint: GET https://joe-market-data.marnick-yezo.workers.dev/token-details
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/joe-market-data-token-details-d9600fe2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bbSOcCIDA9Qao_B61QWtP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability joe-market-data-token-details-d9600fe2
```

Example prompt: What's the current price and market cap of ETH right now? Pull it from CoinGecko via Joe Market Data.

## When to prefer this

Choose this endpoint when you need quick, cheap ($0.001 USDC), per-call cryptocurrency price and market cap lookups sourced from CoinGecko for a single token by symbol. Prefer it over heavier market data APIs when you only need basic token details (price, market cap, name) and don't need order book depth, OHLCV, or exchange-specific data. Works well for AI agents running on Base that need lightweight, metered crypto price enrichment.

## Known failure modes

- Unknown or unsupported token symbol returns an error or empty data
- CoinGecko upstream unavailability causes failed or stale responses
- Missing required 'symbol' query parameter results in a validation error
- Payment failure (x402) if the $0.001 USDC on Base is not authorized or insufficient

## How this service works

Public-data market intel for AI agents: token prices (CoinGecko), DefiLlama TVL/fees/stables, Polymarket odds. Otto-compatible path names. $0.001 USDC per call on Base. No LLM/TTS/image.

## Output

Returns a JSON object with the token's CoinGecko id, full name, ticker symbol, current USD price, and market cap, along with metadata indicating the data source (coingecko), the endpoint used, and the cost per call ($0.001 USDC).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "pathParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Token symbol (e.g. BTC, ETH, SOL)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "id": "bitcoin",
   "name": "Bitcoin",
   "price": 79000,
   "symbol": "BTC",
   "market_cap": 1500000000000
  },
  "meta": {
   "source": "coingecko",
   "endpoint": "/token-details",
   "cost_usdc": "0.001"
  },
  "status": "success"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/joe-market-data-token-details-d9600fe2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from joe-market-data.marnick-yezo.workers.dev](https://www.zero.xyz/host/joe-market-data.marnick-yezo.workers.dev/llms.txt)