# Joe Market Data — Token Price

> Joe Market Data — Token Price 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 the current USD price, market cap, 24h volume, and 24h price change for a cryptocurrency token, sourced from CoinGecko.

## Facts

- Endpoint: GET https://joe-market-data.marnick-yezo.workers.dev/token-price
- 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-price-f8034a93
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RUaU8JmVgSFx3ssNqMV2Z

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-price-f8034a93
```

Example prompt: What's the current price of ETH, including its market cap and how much it's moved in the last 24 hours?

## When to prefer this

Choose this endpoint when you need a single, current token price with market cap, volume, and 24h change for any major or mid-cap cryptocurrency, especially in agent workflows that already use the x402 micropayment protocol on Base. It is purpose-built for AI agents with Otto-compatible path names and a very low per-call cost ($0.001 USDC). Prefer it over direct CoinGecko API access when you need a hosted, agent-friendly wrapper without managing CoinGecko API keys.

## Known failure modes

- Unknown token symbol or CoinGecko ID returns an error — ensure the ticker (e.g. ETH) or CoinGecko slug (e.g. 'ethereum') is valid
- Payment failure if the calling agent's Base wallet lacks sufficient USDC (cost is $0.001 per call)
- CoinGecko upstream outage may cause a 502/503 response
- Rate limiting from the upstream CoinGecko API may cause transient failures

## 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 current USD price, market cap, 24h trading volume, 24h percent price change, and the CoinGecko token ID, plus metadata about the data source, endpoint used, cost in USDC, and a request ID.

## 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": [
      "token"
     ],
     "properties": {
      "token": {
       "type": "string",
       "description": "Ticker symbol or CoinGecko id (alias: symbol). e.g. ETH, BTC, solana"
      },
      "symbol": {
       "type": "string",
       "description": "Alias for token"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "id": "ethereum",
   "price": 2500,
   "token": "ETH",
   "currency": "usd",
   "market_cap": 300000000000,
   "volume_24h": 10000000000,
   "change_24h_pct": 1.2
  },
  "meta": {
   "source": "coingecko",
   "endpoint": "/token-price",
   "cost_usdc": "0.001",
   "request_id": "abc"
  },
  "status": "success"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/joe-market-data-token-price-f8034a93/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)