v1

latestOpenAPI 3.0.32026-08-04850206.9 KB

Coins

List coins

Ranked coins with prices, filters and selectors, paginated with Laravel's links + meta envelope. Prices, marketcap and circulating_supply are decimal strings; changes and ranks are numbers.

get/api/v1/coins

Query parameters

pageinteger nullable

Page number (1-based). Must be at least 1.

Example:1

Page number (1-based). Must be at least 1.

per_pageinteger nullable

Rows per page. The cap is plan-based (Free 100, Starter/Pro 250); exceeding it returns 422 rather than clamping. Must be at least 1. Must not be greater than 100.

Example:50

Rows per page. The cap is plan-based (Free 100, Starter/Pro 250); exceeding it returns 422 rather than clamping. Must be at least 1. Must not be greater than 100.

type'coin' | 'token' nullable

Restrict to a single asset type: coin or token.

Example:coin

Restrict to a single asset type: coin or token.

Listing status: active, delisted, untracked, progressing, awaiting or preparing. Defaults to all public statuses.

Example:active

Listing status: active, delisted, untracked, progressing, awaiting or preparing. Defaults to all public statuses.

searchstring nullable

Free-text match on name or symbol. Must not be greater than 100 characters.

Example:bitcoin

Free-text match on name or symbol. Must not be greater than 100 characters.

min_pricenumber nullable

Only coins priced at or above this USD value. Must be at least 0.

Example:0.5

Only coins priced at or above this USD value. Must be at least 0.

max_pricenumber nullable

Only coins priced at or below this USD value. Must be at least 0.

Example:100000

Only coins priced at or below this USD value. Must be at least 0.

min_marketcapnumber nullable

Only coins with a USD marketcap at or above this value. Must be at least 0.

Example:1000000

Only coins with a USD marketcap at or above this value. Must be at least 0.

max_marketcapnumber nullable

Only coins with a USD marketcap at or below this value. Must be at least 0.

Example:5000000000000

Only coins with a USD marketcap at or below this value. Must be at least 0.

min_volumenumber nullable

Only coins with 24h USD volume at or above this value. Must be at least 0.

Example:1000000

Only coins with 24h USD volume at or above this value. Must be at least 0.

max_volumenumber nullable

Only coins with 24h USD volume at or below this value. Must be at least 0.

Example:100000000000

Only coins with 24h USD volume at or below this value. Must be at least 0.

idsstring nullable

Filter to specific coin ids (CSV, up to 100 selectors combined with slugs/symbols). Must not be greater than 1000 characters.

Example:38,39

Filter to specific coin ids (CSV, up to 100 selectors combined with slugs/symbols). Must not be greater than 1000 characters.

slugsstring nullable

Filter to specific coin slugs (CSV, up to 100 selectors combined). Must not be greater than 2000 characters.

Example:bitcoin,ethereum

Filter to specific coin slugs (CSV, up to 100 selectors combined). Must not be greater than 2000 characters.

symbolsstring nullable

Filter to specific coin symbols (CSV, case-insensitive, up to 100 selectors combined). Must not be greater than 1000 characters.

Example:BTC,ETH

Filter to specific coin symbols (CSV, case-insensitive, up to 100 selectors combined). Must not be greater than 1000 characters.

sortstring nullable

Comma-separated sort fields; prefix with - for descending. Sortable: marketcap, rank, price, volume_24h, change_24h, change_7d. Must not be greater than 100 characters.

Example:-marketcap

Comma-separated sort fields; prefix with - for descending. Sortable: marketcap, rank, price, volume_24h, change_24h, change_7d. Must not be greater than 100 characters.

interval'24h' | '7d' nullable

Movers window for /coins/gainers and /coins/losers only: 24h or 7d.

Example:24h

Movers window for /coins/gainers and /coins/losers only: 24h or 7d.

Response

Example response

{
  "data": [
    {
      "id": 38,
      "slug": "bitcoin",
      "name": "Bitcoin",
      "symbol": "BTC",
      "rank": 1,
      "price": "63520.780763913",
      "marketcap": 1264646594448.5,
      "volume_24h": 5345161962,
      "change_24h": 1.35,
      "change_7d": 4.98,
      "change_rank_24h": 0,
      "change_rank_7d": 0,
      "circulating_supply": "19909179",
      "logo": "https://bitculator.com/storage/media/logo/bitcoin.png",
      "listed_at": "2025-03-15T17:00:43+00:00",
      "last_updated": "2026-06-27T10:34:17+00:00"
    }
  ],
  "links": {
    "first": "https://bitculator.com/api/v1/coins?page=1",
    "last": "https://bitculator.com/api/v1/coins?page=3",
    "prev": null,
    "next": "https://bitculator.com/api/v1/coins?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 3,
    "per_page": 50,
    "to": 50,
    "total": 134
  }
}