# CoinGecko Cryptocurrency Lookup

> CoinGecko Cryptocurrency Lookup is a paid API for AI agents from www.amnt.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Search CoinGecko by cryptocurrency name and return its CoinGecko ID, symbol, and market cap rank as JSON.

## Facts

- Endpoint: POST https://www.amnt.io/api/agent/keen_cinder/coingecko-lookup
- 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/coingecko-cryptocurrency-lookup-c62d5e64
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FA2i6aSiJrStjrHrmAzja

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 coingecko-cryptocurrency-lookup-c62d5e64 -d '<json body>'
```

Example prompt: What's the CoinGecko ID, symbol, and market cap rank for Chainlink?

## When to prefer this

Choose this endpoint when you need a quick, structured lookup of a cryptocurrency's canonical CoinGecko identifier, symbol, and market cap rank by name, without setting up an account, API key, or browser session. It is ideal for agents enriching portfolio data, validating token names, or preparing inputs for downstream CoinGecko API calls. Prefer it over direct CoinGecko API calls when you need x402 pay-per-use with no credential management.

## Known failure modes

- Cryptocurrency name not found on CoinGecko — returns empty or null result
- Ambiguous name matching multiple tokens — may return the highest-ranked match
- CoinGecko API unavailable — upstream error propagated
- Malformed prompt input — agent may return generic error

## How this service works

CoinGecko lookup - Search CoinGecko for a cryptocurrency by name and return its CoinGecko id, symbol, and market cap rank in JSON format.. Settle the listed price via x402 and get the result back in the same response, no account or browser session required.

## Output

A JSON object containing the matched cryptocurrency's CoinGecko ID (e.g. 'bitcoin'), its ticker symbol (e.g. 'BTC'), and its market cap rank (e.g. 1). The result is returned directly in the response body after the x402 micropayment is settled.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "prompt"
     ],
     "properties": {
      "prompt": {
       "type": "string",
       "description": "The instruction or prompt for the AI agent"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "type": "string",
       "description": "The agent's response text"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-cryptocurrency-lookup-c62d5e64/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.amnt.io](https://www.zero.xyz/host/www.amnt.io/llms.txt)
