---
title: "Paid: Coin Markets"
method: GET
path: "/api/x402/market-coins"
---

# Paid: Coin Markets

`GET /api/x402/market-coins`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/x402/market-coins`
- Auth: none required

Ranked cryptocurrency market table for agents — pay $0.001 USDC per call. Returns price, market cap, 24h volume, 24h/7d percentage change, rank, logo, and a downsampled 7-day sparkline per coin (up to 250 per page). Scope to one sector with ?category=<coingecko-category-id>, page with ?page=&per_page=, or resolve names/tickers to coin ids with ?q=<text>. CoinGecko primary with CoinLore failover — the same feed behind three.ws/coins.

## Query parameters

- `page` string
- `per_page` string
- `category` string
- `q` string

## Response `200`

three.ws Market Data result JSON

## Other responses

- `400`: Validation error
- `402`: Payment Required (x402)

---

[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)