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 five tools: search, list_categories and get_details are free, use and batch_use are 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

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

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

id
string
required

Coin ID

symbol
string
required

Coin symbol

name
string
required

Coin name

web_slug
string
required

Coin web slug

asset_platform_id
string | null
required

Coin asset platform ID

platforms
object
required

Coin asset platform and contract address

detail_platforms
object
required

Detailed coin asset platform and contract address

block_time_in_minutes
number
required

Blockchain block time in minutes

hashing_algorithm
string | null
required

Blockchain hashing algorithm

categories
string[]
required

Coin categories

preview_listing
boolean
required

Preview listing coin

public_notice
string | null
required

Public notice

additional_notices
string[]
required

Additional notices

has_supply_breakdown
boolean
required

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

description
object
required

Coin description

Links

image
object
required

Coin image URL

country_origin
string
required

Country of origin

genesis_date
string | null
required

Genesis date

contract_address
string
required

Coin contract address

sentiment_votes_up_percentage
number | null
required

Sentiment votes up percentage

sentiment_votes_down_percentage
number | null
required

Sentiment votes down percentage

watchlist_portfolio_users
number
required

Number of users watching this coin in portfolio

market_cap_rank
integer | null
required

Market cap rank

market_cap_rank_with_rehypothecated
integer | null
required

Market cap rank including rehypothecated tokens

status_updates
object[]
required

Status updates

last_updated
string
required

Last updated timestamp

localization
object

Coin name localization

market_data
object

Market data

tickers
object[]

Tickers