← APIs / CoinGecko
Verified

CoinGecko

Apiosk Basicsby Apiosk Basics · General

Crypto market data: live coin prices, market caps, rankings and trending coins across thousands of assets and fiat currencies.

financeapi
Price per request
$0.06
About

CoinGecko is the most widely used independent source of cryptocurrency market data — price, volume, market cap and metadata for thousands of coins across hundreds of exchanges. This listing proxies the CoinGecko API through the Apiosk gateway with pay-per-call x402 billing; no CoinGecko account or key is needed on the caller side. Ideal for agents that need live crypto prices, market rankings, trending coins, or to resolve a coin's id/symbol.

Base URL
https://gateway.apiosk.com/coingecko
Technical Specs
Auth MethodapiKey
Response FormatJSON
Endpoints4
Endpoints
MethodPathDescriptionCost
GET /coins/list The full list of coins CoinGecko tracks — each with its id, symbol and name. Use the id to query prices and market data.
$0.06 default
View details
GET /coins/markets Ranked market data (price, market cap, 24h high/low, volume, ATH/ATL, supply) for coins in a given currency.
$0.07 default
View details
GET /search/trending The top trending coins on CoinGecko over the last 24 hours, ranked by how often users searched them.
$0.06 default
View details
GET /simple/price Live price of one or more coins in one or more fiat/crypto currencies, with optional market cap and 24h change.
$0.06 default
View details
Endpoint documentation
GET/coins/list
$0.06 default
Description

The full list of coins CoinGecko tracks — each with its id, symbol and name. Use the id to query prices and market data.

Pricing
$0.06 default
Parameters
{}
Response schema
{
  "items": {
    "properties": {
      "id": {
        "description": "CoinGecko coin id used in other endpoints.",
        "type": "string"
      },
      "name": {
        "type": "string"
      },
      "symbol": {
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}
Example response
[
  {
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "btc"
  },
  {
    "id": "ethereum",
    "name": "Ethereum",
    "symbol": "eth"
  },
  {
    "id": "solana",
    "name": "Solana",
    "symbol": "sol"
  }
]
GET/coins/markets
$0.07 default
Description

Ranked market data (price, market cap, 24h high/low, volume, ATH/ATL, supply) for coins in a given currency.

Pricing
$0.07 default
Parameters
{
  "order": {
    "description": "Sort order, e.g. market_cap_desc.",
    "example": "market_cap_desc",
    "required": false,
    "type": "string"
  },
  "page": {
    "description": "Page number.",
    "example": "1",
    "required": false,
    "type": "integer"
  },
  "per_page": {
    "description": "Results per page (1-250).",
    "example": "10",
    "required": false,
    "type": "integer"
  },
  "vs_currency": {
    "description": "Target currency for prices/market cap.",
    "example": "usd",
    "required": true,
    "type": "string"
  }
}
Response schema
{
  "description": "One object per coin, ordered by market cap rank.",
  "items": {
    "properties": {
      "ath": {
        "type": "number"
      },
      "circulating_supply": {
        "type": "number"
      },
      "current_price": {
        "type": "number"
      },
      "id": {
        "type": "string"
      },
      "market_cap": {
        "type": "number"
      },
      "market_cap_rank": {
        "type": "integer"
      },
      "max_supply": {
        "type": [
          "number",
          "null"
        ]
      },
      "name": {
        "type": "string"
      },
      "price_change_percentage_24h": {
        "type": "number"
      },
      "symbol": {
        "type": "string"
      },
      "total_volume": {
        "type": "number"
      }
    },
    "type": "object"
  },
  "type": "array"
}
Example response
[
  {
    "ath": 126080,
    "circulating_supply": 20051143,
    "current_price": 61739,
    "high_24h": 62060,
    "id": "bitcoin",
    "low_24h": 59540,
    "market_cap": 1237823142839,
    "market_cap_rank": 1,
    "max_supply": 21000000,
    "name": "Bitcoin",
    "price_change_percentage_24h": 2.79,
    "symbol": "btc",
    "total_volume": 43436698617
  }
]
GET/search/trending
$0.06 default
Description

The top trending coins on CoinGecko over the last 24 hours, ranked by how often users searched them.

Pricing
$0.06 default
Parameters
{}
Response schema
{
  "properties": {
    "coins": {
      "items": {
        "properties": {
          "item": {
            "properties": {
              "data": {
                "properties": {
                  "price": {
                    "type": "number"
                  }
                },
                "type": "object"
              },
              "id": {
                "type": "string"
              },
              "market_cap_rank": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              },
              "symbol": {
                "type": "string"
              }
            },
            "type": "object"
          }
        },
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}
Example response
{
  "coins": [
    {
      "item": {
        "coin_id": 102174035,
        "data": {
          "price": 0.16969
        },
        "id": "the-black-bull",
        "market_cap_rank": 346,
        "name": "The Black Bull",
        "symbol": "ANSEM"
      }
    }
  ]
}
GET/simple/price
$0.06 default
Description

Live price of one or more coins in one or more fiat/crypto currencies, with optional market cap and 24h change.

Pricing
$0.06 default
Parameters
{
  "ids": {
    "description": "Comma-separated CoinGecko coin ids (see /coins/list).",
    "example": "bitcoin,ethereum",
    "required": true,
    "type": "string"
  },
  "include_24hr_change": {
    "description": "Include 24h change percent.",
    "example": "true",
    "required": false,
    "type": "boolean"
  },
  "include_market_cap": {
    "description": "Include market cap per currency.",
    "example": "true",
    "required": false,
    "type": "boolean"
  },
  "vs_currencies": {
    "description": "Comma-separated target currencies.",
    "example": "usd,eur",
    "required": true,
    "type": "string"
  }
}
Response schema
{
  "additionalProperties": {
    "properties": {
      "usd": {
        "description": "Price in the requested currency (key repeats per currency).",
        "type": "number"
      },
      "usd_24h_change": {
        "description": "24h price change in percent.",
        "type": "number"
      },
      "usd_market_cap": {
        "type": "number"
      }
    },
    "type": "object"
  },
  "description": "Map of coin id to an object of price fields, one set per requested currency.",
  "type": "object"
}
Example response
{
  "bitcoin": {
    "eur": 54012,
    "usd": 61738,
    "usd_24h_change": 2.79,
    "usd_market_cap": 1237823142838.77
  },
  "ethereum": {
    "eur": 1487.46,
    "usd": 1700.25,
    "usd_24h_change": 5.07
  }
}