---
title: "CoinGecko: Ranked market data (price, market cap, volume, change) per coin."
method: GET
path: "/api/v1/x/coingecko/markets"
tags: ["Crypto API (aggregator)"]
---

# CoinGecko: Ranked market data (price, market cap, volume, change) per coin.

`GET /api/v1/x/coingecko/markets`

## Request

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

Ranked market data (price, market cap, volume, change) per coin. Billing lanes, in order: free tier (30/min, 2000/day per IP, no credentials) → x402 pay-per-call ($0.002 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

- `vs_currency` string
- `ids` string
- `order` string
- `per_page` string
- `page` 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)