Skip to main content
GET
Coin Price by Token Addresses
Price lookup keyed by on-chain contract address rather than CoinGecko id. id is the asset platform, contract_addresses a comma-separated list of token addresses, vs_currencies the quote currency. Returns a map keyed by lowercase contract address whose field names are built from the quote currency — 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 when you hold an address and no id. For the token’s full profile use get_coingecko_token_data; if you already have the CoinGecko id use get_coingecko_simple_price.
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/token_price/{id}
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/coingecko/simple/token_price/{id}
  • id: path; required
  • contract_addresses: query; required
  • include_24hr_change: query; optional
  • include_24hr_vol: query; optional
  • include_last_updated_at: query; optional
  • include_market_cap: query; optional
  • precision: 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.

Path Parameters

id
string
default:ethereum
required

Asset platform's ID. *refers to /asset_platforms

Query Parameters

contract_addresses
string
default:0x2260fac5e5542a773aa44fbcfedf7c193bc2c599
required

Token contract addresses, comma-separated if querying more than 1 token

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

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
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

Token prices

{key}
object