# Cross-Source Token Price Aggregator (CoinGecko + DexScreener + GeckoTerminal)

> Cross-Source Token Price Aggregator (CoinGecko + DexScreener + GeckoTerminal) is a paid API for AI agents from meryol-agenticmarket-x402.hf.space, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Returns a median USD price for any ERC-20 token or ticker across CoinGecko, DexScreener, and GeckoTerminal, with per-source quotes and spread in basis points to detect stale feeds or arbitrage windows.

## Facts

- Endpoint: GET https://meryol-agenticmarket-x402.hf.space/price/cross/:chain/:token?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meryol-agenticmarket-x402-hf-space-1d324434
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WkPfPtikdfkN1ot4K-SSL

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 meryol-agenticmarket-x402-hf-space-1d324434
```

Example prompt: What's the current median price of USDC on Base right now — pull it from CoinGecko, DexScreener, and GeckoTerminal and show me the spread in basis points so I can see if any source is stale or off.

## When to prefer this

Choose this endpoint when you need a robust, cross-validated token price rather than trusting a single data source. Ideal before executing swaps, quotes, or any financial logic where stale or manipulated price feeds could be costly. Better than querying CoinGecko or DexScreener alone because it exposes dead sources, computes the spread in bps, and surfaces arbitrage windows in one call. Supports both human-readable tickers and raw ERC-20 contract addresses.

## Known failure modes

- Unknown ticker symbol returns null price_usd with a 'unknown_symbol' note per source and null median
- Contract address not indexed by any source returns all null prices and null spread
- Chain not in supported set (ethereum/base/arbitrum/optimism) results in 404 or validation error
- All three sources down or timing out returns null median with dead source flags
- Payment not provided or insufficient results in 402 Payment Required response

## How this service works

Gets a token's price across chains for the specified network and token.

## Output

A JSON object containing the median USD price across all responding sources, per-source individual price quotes (with nulls for dead/unknown sources), the spread in basis points between highest and lowest source, the chain queried, and the token requested. Useful for detecting stale oracle feeds or arbitrage windows before quoting.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "pathParams": {
   "chain": "ethereum",
   "token": "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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "chain",
      "token"
     ],
     "properties": {
      "chain": {
       "enum": [
        "ethereum",
        "base",
        "arbitrum",
        "optimism"
       ],
       "type": "string"
      },
      "token": {
       "type": "string",
       "description": "ticker (eth/usdc/aero) or 0x address"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "median_price_usd",
      "sources"
     ]
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meryol-agenticmarket-x402-hf-space-1d324434/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meryol-agenticmarket-x402.hf.space](https://www.zero.xyz/host/meryol-agenticmarket-x402.hf.space/llms.txt)
