# CoinGecko Crypto Search by Name or Symbol

> CoinGecko Crypto Search by Name or Symbol is a paid API for AI agents from x402-gateway-production.up.railway.app, paid per call via x402, $0.001000/call, status unknown (last checked 2026-09-15).

Search for a cryptocurrency by name or ticker symbol and retrieve its CoinGecko ID

## Facts

- Endpoint: GET https://x402-gateway-production.up.railway.app/api/crypto/search
- Price: $0.001000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-gateway-production-up-railway-app-435f6891
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CZfzu_H8Gz7beUcn3Qx4R

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 x402-gateway-production-up-railway-app-435f6891
```

Example prompt: What's the CoinGecko ID for Solana? I want to look it up by its symbol SOL.

## When to prefer this

Use this endpoint when you have a human-readable coin name or ticker symbol and need to resolve it to a CoinGecko coin ID before calling price, market cap, or historical data endpoints. Prefer this over guessing or hardcoding IDs, especially for less common tokens.

## Known failure modes

- Coin not found — returns empty results or 404 if the name/symbol does not match any known coin
- Ambiguous symbol — multiple coins share the same ticker (e.g. 'BTC' variants), may return multiple results
- Rate limit or payment failure — 402 payment required if x402 micropayment header is missing or insufficient
- Network timeout from upstream CoinGecko API

## How this service works

Search for a coin by name or symbol to get its CoinGecko ID

## Output

Returns the CoinGecko coin ID (e.g. 'solana', 'bitcoin', 'ethereum') along with the canonical name and symbol for the matched cryptocurrency, which can then be used as input to CoinGecko price or market data endpoints.

## 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": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "example": "bitcoin",
       "description": "Search query (coin name or symbol)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-gateway-production-up-railway-app-435f6891/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-gateway-production.up.railway.app](https://www.zero.xyz/host/x402-gateway-production.up.railway.app/llms.txt)
