CEX Market Details

GET /api/v1/market/:id

Detailed market data for a single token from centralized exchange sources.

Cost: $0.005 USDC

Path Parameters

Param	Type	Description
id	string	CoinGecko token ID (e.g. bitcoin, ethereum, solana)

Request Example

curl -H "x-payment: <proof>" \
  https://api.foursec.xyz/api/v1/market/bitcoin

const res = await fetchWithPayment(
  "https://api.foursec.xyz/api/v1/market/ethereum"
);
const data = await res.json();

Response

{
  "success": true,
  "data": {
    "id": "ethereum",
    "symbol": "eth",
    "name": "Ethereum",
    "price": 2450.18,
    "change_24h": 1.82,
    "change_7d": 5.43,
    "change_30d": -8.21,
    "volume_24h": 12500000000,
    "market_cap": 295000000000,
    "market_cap_rank": 2,
    "circulating_supply": 120000000,
    "total_supply": null,
    "ath": 4891.70,
    "ath_date": "2021-11-10T00:00:00Z",
    "atl": 0.432979,
    "atl_date": "2015-10-20T00:00:00Z",
    "last_updated": "2026-07-08T14:30:00Z",
    "source": "ccxt_binance"
  }
}

CoinGecko IDs

Common token IDs: bitcoin, ethereum, solana, ripple, binancecoin, cardano, dogecoin, avalanche-2, polkadot, chainlink, matic-network, uniswap, arbitrum, optimism

Data Source

CCXT multi-exchange (primary) with CoinGecko fallback. Cache TTL: 30 seconds.

Related Endpoints

• Batch Prices — GET /api/v1/prices?symbols=btc,eth
• Historical Data — OHLCV history