# CoinGecko Price Check

> CoinGecko Price Check 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).

Returns the current USD spot price for any cryptocurrency by its CoinGecko coin ID (e.g. 'bitcoin', 'ethereum').

## Facts

- Endpoint: POST https://www.amnt.io/api/agent/olive_arrow/coingecko-price-check
- 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-price-check-230fcd53
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qvai6nvM4npgBbGwE6_9z

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-price-check-230fcd53 -d '<json body>'
```

Example prompt: What's the current USD price of Ethereum according to CoinGecko? Use the coin ID 'ethereum'.

## When to prefer this

Use this endpoint when you need a quick, no-account-required USD spot price for any cryptocurrency by its CoinGecko coin ID, especially in agentic workflows where setting up API keys or browser sessions is impractical. Prefer this over raw CoinGecko API calls when operating under the x402 micropayment model at $0.001 per call.

## Known failure modes

- Invalid or unrecognized CoinGecko coin ID returns an error or empty result
- Network timeout if CoinGecko's upstream API is slow or down
- Payment failure if x402 settlement is rejected
- Stale price data if CoinGecko's feed is delayed
- Rate limiting from upstream CoinGecko if called too frequently

## Output

Returns CoinGecko's JSON price response for the requested coin ID, including the current USD spot price. The agent receives a structured JSON object with the price data as returned by CoinGecko's API, wrapped in the endpoint's response format.

## 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-price-check-230fcd53/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)