# signals.edge.report Token Price Lookup

> signals.edge.report Token Price Lookup is a paid API for AI agents from signals.edge.report, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns USD price, market cap, and 24h volume for a crypto token by CoinGecko ID or Base ERC20 contract address.

## Facts

- Endpoint: GET https://signals.edge.report/v1/token
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/signals-edge-report-token-price-lookup-98de6928
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ezEGQaw5ZZH-N7RSYkTDH

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 signals-edge-report-token-price-lookup-98de6928
```

Example prompt: What's the current USD price, market cap, and 24h volume for Ethereum — you can use its CoinGecko ID 'ethereum'?

## When to prefer this

Choose this endpoint when you need a quick, cheap ($0.001 USDC) spot price check for a single token by CoinGecko ID or Base ERC20 contract address, and you need USD price, market cap, and volume in one call. Prefer this over generic DeFi bundles when you only need price data and not funding rates, gas fees, or wallet balances.

## Known failure modes

- Invalid or unrecognized CoinGecko ID returns an error or empty result
- Unsupported or non-Base ERC20 contract address fails to resolve
- CoinGecko upstream outage causes stale or missing data
- Rate limiting or payment failure returns a 402 Payment Required error
- Malformed contract address format causes query rejection

## How this service works

Token price lookup: USD price, market cap, and volume by CoinGecko id or Base ERC20 contract address. Use for spot token price checks.

## Output

Returns a JSON object containing the token's current USD price, market capitalization, and 24-hour trading volume, sourced from CoinGecko data. The response is keyed to the queried token identifier.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "CoinGecko token id (e.g. ethereum) or Base ERC20 contract address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "ethereum",
  "source": "coingecko",
  "priceUsd": 3000,
  "marketCapUsd": 360000000000,
  "volume24hUsd": 15000000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signals-edge-report-token-price-lookup-98de6928/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from signals.edge.report](https://www.zero.xyz/host/signals.edge.report/llms.txt)