---
title: "CoinGecko: Spot price for one or more coins in any fiat/crypto."
method: GET
path: "/api/v1/x/coingecko/price"
tags: ["Crypto API (aggregator)"]
---

# CoinGecko: Spot price for one or more coins in any fiat/crypto.

`GET /api/v1/x/coingecko/price`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/v1/x/coingecko/price`
- Auth: none required

Spot price for one or more coins in any fiat/crypto. Billing lanes, in order: free tier (30/min, 2000/day per IP, no credentials) → x402 pay-per-call ($0.001 USDC via HTTP 402, no credentials) — or send your own upstream key via BYOK, or authenticate with a three.ws API key / OAuth session / browser session for the plan lane.

## Query parameters

- `ids` string, required
- `vs_currencies` string
- `include_24hr_change` string
- `include_market_cap` string

## Response `200`

Normalized upstream response, wrapped as { data, _meta }

## Other responses

- `400`: Missing or invalid parameter
- `402`: Payment Required (x402) — no credentials and free quota (if any) exhausted
- `404`: Unknown provider/endpoint pair
- `429`: Rate limited

---

[API](https://skmtc.dev/three/apis/three-ws-api.md) · [All operations](https://skmtc.dev/three/apis/three-ws-api/llms.txt) · [OpenAPI document](https://skmtc.dev/three/apis/three-ws-api/revisions/dbc5e3a81b79?raw)