# Joe Market Data – Token Fundamentals

> Joe Market Data – Token Fundamentals 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).

Fetches fundamental market data for a crypto token (price, market cap, FDV, circulating supply, rank) via CoinGecko, billed at $0.001 USDC per call on Base.

## Facts

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

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-fundamentals-ebe0a4cd
```

Example prompt: What are the current fundamentals for ETH — price, market cap, FDV, circulating supply, and CoinGecko rank?

## When to prefer this

Choose this endpoint when you need lightweight, low-cost ($0.001 USDC) token fundamental data — price, market cap, FDV, supply, and rank — sourced from CoinGecko for a single ticker. Prefer it over heavier analytics platforms when you only need quick token-level snapshots without on-chain computation or historical data. It is especially suitable for AI agents needing to embed real-time crypto fundamentals into reasoning or reports without building a CoinGecko integration themselves.

## Known failure modes

- Unknown or misspelled token symbol returns an error or empty data
- CoinGecko API downtime causes upstream failure
- Rate limiting on the underlying CoinGecko API may result in delayed or failed responses
- Missing required 'symbol' query parameter causes a 400-level error
- Very new or low-liquidity tokens may not be indexed on CoinGecko and return no data

## 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 containing the token's current price (USD), market cap, fully diluted valuation (FDV), circulating supply, CoinGecko rank, and the ticker symbol, 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 ticker, 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": {
   "fdv": 300000000000,
   "rank": 2,
   "price": 2500,
   "supply": {
    "circulating": 120000000
   },
   "symbol": "ETH",
   "market_cap": 300000000000
  },
  "meta": {
   "source": "coingecko",
   "endpoint": "/token-fundamentals",
   "cost_usdc": "0.001"
  },
  "status": "success"
 }
}
```

## More

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