Skip to main content
GET
Coin Data by Token Address
A full coin profile looked up by contract address instead of CoinGecko id. id is the asset platform and contract_address the token; both are required and there are no other parameters. Returns the same shape as get_coingecko_coins_id — description, links, image, categories, platforms, detail_platforms, market_cap_rank, a market_data block and an embedded tickers array — plus contract_address itself. Use it to identify an unknown token from an address. If only the current price is needed, get_coingecko_simple_token_price_id is far lighter.
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}/contract/{contract_address}
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/coingecko/coins/{id}/contract/{contract_address}
  • contract_address: path; required
  • id: path; 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

contract_address
string
default:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
required

The contract address of token.

id
string
default:ethereum
required

Asset platform ID. *refers to /asset_platforms.

Response

Coin data by token contract address

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

contract_address
string
required

Coin contract address

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

localization
object

Coin name localization

market_data
object

Market data

tickers
object[]

Tickers