# Apiosk Gateway – CoinGecko Execute

> Apiosk Gateway – CoinGecko Execute is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Executes a CoinGecko API operation via the Apiosk pay-per-call x402 gateway, forwarding JSON payloads to CoinGecko endpoints and returning the upstream response.

## Facts

- Endpoint: POST https://gateway.apiosk.com/coingecko/execute
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apiosk-gateway-coingecko-execute-63efc771
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6rhXjVl4BaslrtlmeXWF9

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 apiosk-gateway-coingecko-execute-63efc771 -d '<json body>'
```

Example prompt: What's the current price of Ethereum in USD? Use the CoinGecko simple price endpoint with the operation GET /simple/price and pass in id=ethereum and vs_currencies=usd.

## When to prefer this

Choose this endpoint when you need programmatic access to CoinGecko market data (prices, market caps, volumes, coin lists, trending tokens) and want to pay per call via USDC on Base without managing a CoinGecko API key subscription. Ideal for agents that need occasional or low-volume crypto data lookups billed on-demand rather than via monthly subscription.

## Known failure modes

- Invalid operation selector returns an error from the gateway before reaching CoinGecko
- Malformed JSON payload results in upstream 400 Bad Request from CoinGecko
- Unknown coin ID or unsupported currency causes CoinGecko to return a 404 or empty result
- Rate limits or CoinGecko API downtime cause upstream 429 or 503 errors
- Insufficient USDC balance or failed x402 payment causes the gateway to reject the request before execution

## How this service works

Pay-per-call API gateway on the x402 protocol (HTTP 402 + USDC on Base). This document covers the gateway's discovery and execution meta-endpoints. Individual provider APIs are reachable at /{api_slug}/{path} and described by GET /{api_slug}/metadata.

## Output

Returns a JSON object containing the status of the gateway call, the upstream CoinGecko response body (e.g. price data, coin metadata, market stats), the operation that was executed, the latency in milliseconds, the cost of the call in USDC, and the HTTP status code returned by CoinGecko.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "string",
   "description": "JSON payload forwarded to the selected operation."
  },
  "operation": {
   "type": "string",
   "description": "Operation id, /path, or METHOD /path selector."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "result"
 ],
 "properties": {
  "api": {
   "type": "string"
  },
  "cost": {
   "type": "string"
  },
  "result": {
   "description": "Upstream response body."
  },
  "status": {
   "type": "string"
  },
  "latency": {
   "type": "number"
  },
  "operation": {
   "type": "string"
  },
  "upstream_status": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apiosk-gateway-coingecko-execute-63efc771/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)
