Start building

CoinGecko Coin Price by Token Addresses

https://api.sandbase.ai/v1/api/coingecko/simple-token-price

Get one or more token prices using their token contract addresses

Try this APIGet API key
Price
$0.01USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
3 required · 5 optional
Production route

Try the model

Playground

Open playground
Input
Asset platform's ID. *refers to [`/asset_platforms`](/reference/asset-platforms-list)
Token contract addresses, comma-separated if querying more than 1 token
Include 24-hour change percentage. Default: false
Include 24-hour trading volume. Default: false
Include last updated price time as a UNIX timestamp. Default: false
Include market capitalization. Default: false
Decimal places for currency price value Allowed values: full, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18.
Target currency of coins, comma-separated if querying more than 1 currency. *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies)
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.01 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

id
string · required
contract_addresses
string · required
vs_currencies
string · required
include_24hr_change
boolean · optional
include_24hr_vol
boolean · optional
include_last_updated_at
boolean · optional
include_market_cap
boolean · optional
precision
string (full, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18) · optional

Access

Provider
CoinGecko
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/coingecko/simple-token-price
Authentication
Bearer API key

API README

CoinGecko Coin Price by Token Addresses API

Get one or more token prices using their token contract addresses

The response is the official CoinGecko API response, unchanged.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "coingecko/simple-token-price", "id": "ethereum", "contract_addresses": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599", "vs_currencies": "usd"}'

Parameters

NameTypeRequiredDescription
idstringYesAsset platform's ID. *refers to /asset_platforms
contract_addressesstringYesToken contract addresses, comma-separated if querying more than 1 token
include_24hr_changebooleanNoInclude 24-hour change percentage. Default: false
include_24hr_volbooleanNoInclude 24-hour trading volume. Default: false
include_last_updated_atbooleanNoInclude last updated price time as a UNIX timestamp. Default: false
include_market_capbooleanNoInclude market capitalization. Default: false
precisionstringNoDecimal places for currency price value
vs_currenciesstringYesTarget currency of coins, comma-separated if querying more than 1 currency. *refers to [/simple/supported_vs_currencies](/reference/simple-supported-currencie

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/coingecko/simple-token-price
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/coingecko/simple-token-price" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "id": "ethereum",
  "vs_currencies": "usd",
  "contract_addresses": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
CoinGecko Coin Price by Token AddressesThis API
CoinGecko		$0.01 per callJSONOct 30, 2026
CoinGecko Exchange Volume Chart by ID
CoinGecko		$0.01 per callJSONOct 30, 2026
CoinGecko Coin Data by ID
CoinGecko		$0.01 per callJSONOct 30, 2026
CoinGecko Coins Categories List with Market Data
CoinGecko		$0.01 per callJSONOct 30, 2026
CoinGecko Coins Categories List (ID Map)
CoinGecko		$0.01 per callJSONOct 30, 2026
CoinGecko Coin Data by Token Address
CoinGecko		$0.01 per callJSONOct 30, 2026

Questions

FAQ

How do I use the CoinGecko Coin Price by Token Addresses API?

Send a POST request to https://api.sandbase.ai/v1/api/coingecko/simple-token-price with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the CoinGecko Coin Price by Token Addresses API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the CoinGecko Coin Price by Token Addresses API accept?

Required: id (string), contract_addresses (string) and vs_currencies (string). Optional: include_24hr_change (boolean), include_24hr_vol (boolean), include_last_updated_at (boolean), include_market_cap (boolean) and precision (one of full, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18). The Parameters table and the Playground on this page list every field.

What does the CoinGecko Coin Price by Token Addresses API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a CoinGecko developer account or API key?

No. CoinGecko Coin Price by Token Addresses runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for CoinGecko API access separately.