Skip to main content
GET
Reference example
Everything CoinGecko holds on one coin, selected by id: description, links, image, categories, platforms and detail_platforms (contract addresses per chain), market_cap_rank, and a market_data block carrying current_price, market_cap, total_volume, fully_diluted_valuation, ath and atl with dates and change percentages. The heavy sections are opt-in via market_data, community_data, developer_data, tickers, sparkline and localization — leave them off unless needed, the full payload is large. Use it for a coin profile. For a price table across many coins use get_coingecko_coins_markets; to look the same coin up by contract address use get_coingecko_token_data.
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/coins/{id}
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/coingecko/coins/{id}
  • id: path; required
  • community_data: query; optional
  • developer_data: query; optional
  • dex_pair_format: query; optional
  • include_categories_details: query; optional
  • localization: query; optional
  • market_data: query; optional
  • sparkline: query; optional
  • tickers: query; optional
  • Runtime facts: 2cebdc98d47ae0d3c355af637caf87081b8a62f7794a0c3667fcd49e4539823e
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.008 USD per successful request. Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.008
  • Declared unit rate (USD): 0.0
  • Billing unit: provider_credit
  • Cost contract: plan_units
  • Settlement evidence source: request_snapshot

Declared request billing units

  • Units: 1

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
default:bitcoin
required

Coin ID. *refers to /coins/list

Example:

"bitcoin"

Query Parameters

community_data
boolean

Include community data. Deprecated: has no effect as of 28 August 2026; the community_data object is no longer returned.

developer_data
boolean

Include developer data. Deprecated: has no effect as of 28 August 2026; the developer_data object is no longer returned.

dex_pair_format
enum<string>

Set to symbol to display DEX pair base and target as symbols. Default: contract_address

Available options:
contract_address,
symbol
include_categories_details
boolean

Include categories details. Default: false

localization
boolean

Include all localized languages in the response. Default: true

market_data
boolean

Include market data. Default: true

sparkline
boolean

Include sparkline 7-day data. Default: false

tickers
boolean

Include tickers data. Default: true

Response

Coin data

additional_notices
string[]
required

Additional notices

asset_platform_id
string | null
required

Coin asset platform ID

block_time_in_minutes
number
required

Blockchain block time in minutes

categories
string[]
required

Coin categories

country_origin
string
required

Country of origin

description
object
required

Coin description

detail_platforms
object
required

Detailed coin asset platform and contract address

genesis_date
string | null
required

Genesis date

has_supply_breakdown
boolean
required

Whether detailed supply breakdown data is available via /coins/supply_breakdown

hashing_algorithm
string | null
required

Blockchain hashing algorithm

id
string
required

Coin ID

image
object
required

Coin image URL

last_updated
string
required

Last updated timestamp

Links

market_cap_rank
integer | null
required

Market cap rank

market_cap_rank_with_rehypothecated
integer | null
required

Market cap rank including rehypothecated tokens

name
string
required

Coin name

platforms
object
required

Coin asset platform and contract address

preview_listing
boolean
required

Preview listing coin

public_notice
string | null
required

Public notice

sentiment_votes_down_percentage
number | null
required

Sentiment votes down percentage

sentiment_votes_up_percentage
number | null
required

Sentiment votes up percentage

status_updates
object[]
required

Status updates

symbol
string
required

Coin symbol

watchlist_portfolio_users
number
required

Number of users watching this coin in portfolio

web_slug
string
required

Coin web slug

categories_details
object[]

Detailed coin categories

ico_data
object | null

ICO data

localization
object

Coin name localization

market_data
object

Market data

tickers
object[]

Tickers