Skip to main content
GET
Coin Price by IDs, Symbols, or Names
The cheapest price lookup: pass comma-separated CoinGecko ids and vs_currencies, get back a map keyed by coin id. Field names are built from the quote currency — with vs_currencies set to usd you get usd, plus usd_market_cap, usd_24h_vol, usd_24h_change and last_updated_at when the matching include_market_cap, include_24hr_vol, include_24hr_change and include_last_updated_at flags are set. Use it whenever the ids are already known and only current numbers are needed. For rank, supply or all-time-high data use get_coingecko_coins_markets; if you hold a contract address rather than an id use get_coingecko_simple_token_price_id.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: GET /apis/v1/coingecko/simple/price
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/coingecko/simple/price
  • ids: query; optional
  • include_24hr_change: query; optional
  • include_24hr_vol: query; optional
  • include_last_updated_at: query; optional
  • include_market_cap: query; optional
  • include_tokens: query; optional
  • names: query; optional
  • precision: query; optional
  • symbols: query; optional
  • vs_currencies: query; required
Complete OpenAPI definition Effective request declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.008 USD per successful request. Your account price may differ; use a request quote where supported.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

ids
string
default:bitcoin

Coins' IDs, comma-separated if querying more than 1 coin. *refers to /coins/list

include_24hr_change
boolean

Include 24-hour change percentage. Default: false

include_24hr_vol
boolean

Include 24-hour trading volume. Default: false

include_last_updated_at
boolean

Include last updated price time as a UNIX timestamp. Default: false

include_market_cap
boolean

Include market capitalization. Default: false

include_tokens
enum<string>

For symbols lookups, specify all to include all matching tokens. Default top returns top-ranked tokens by market cap or volume.

Available options:
top,
all
names
string
default:Bitcoin

Coins' names, comma-separated if querying more than 1 coin.

precision
enum<string>

Decimal places for currency price value

Available options:
full,
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18
symbols
string
default:btc

Coins' symbols, comma-separated if querying more than 1 coin.

vs_currencies
string
default:usd
required

Target currency of coins, comma-separated if querying more than 1 currency. *refers to /simple/supported_vs_currencies.

For the complete list of fiat currencies supported by this endpoint, see Fiat Currencies Support List.

Response

Coin prices

{key}
object