---
title: "Paid: Coin Profile"
method: GET
path: "/api/x402/market-coin"
---

# Paid: Coin Profile

`GET /api/x402/market-coin`

## Request

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

Rich single-coin profile for agents — pay $0.001 USDC per call. Pass ?id=<coingecko-id> (e.g. bitcoin) or ?contract=<solana-mint>. Returns live market stats (price, cap, FDV, volume, 1h→1y change windows, ATH/ATL, supply), official links, per-chain contract addresses, developer activity, community size, sentiment votes, and a sanitized plain-text description. The id or contract is supplied at runtime — generic coin-agnostic plumbing, same data behind the three.ws/coin pages.

## Query parameters

- `id` string
- `contract` 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)