Skip to Content
ServicesMarket REST APIGet asset profile

Get asset profile

Read canonical identity and metadata for one asset.

Use this before pulling market state when the agent needs a stable asset object.

Back to Market API

This is the canonical REST read behind the friendlier market.resolve_asset handle.

Access

  • Surfaces: mcp, rest, skill
  • Metering: mcp_call, rest_call
  • Scope: DEX available · EVM family primary · Solana (Beta)

Handles

SurfaceLabelValue
mcpMCPmarket.resolve_asset
restRESTGET /v1/market/asset-profile
skillSkillmarket.resolve_asset

Availability

DEX asset coverage is Available. Unsupported CEX paths return explicit errors.

Request example

GET https://gw-aql.tomo.services/v1/market/asset-profile?market_kind=dex&chain=ethereum&address=0xC02aaA39b223FE8D0A0E5C4F27eAD9083C756Cc2

Try send

Try send

Try asset profile

Send one direct browser request to the current hosted gateway base URL so the real network request is visible in devtools. The API key is only stored locally when you provide one.

Response example

{ "asset_profile": { "market_kind": "dex", "chain": "ethereum", "address": "0xC02aaA39b223FE8D0A0E5C4F27eAD9083C756Cc2", "symbol": "WETH", "name": "Wrapped Ether", "source_id": "gdex" }, "freshness_ms": 120, "source_status": "healthy" }

Request fields

Query parameters

FieldTypeRequiredNotes
market_kindstringRequiredMarket family. Use `dex` for now.
chainstringRequiredChain key. Prefer the current EVM family such as `ethereum` or `base`; use `solana` only for the separate Beta lane.
addressstringRequiredToken, market, or pool address.

Response fields

Asset profile

FieldTypeNotes
asset_profile.market_kindstringMarket family.
asset_profile.chainstringAsset chain.
asset_profile.addressstringAsset address.
asset_profile.symbolstringAsset symbol.
asset_profile.namestringAsset name.
asset_profile.source_idstringBacking source id.

Response metadata

FieldTypeNotes
freshness_msnumberData age in milliseconds.
source_statusstringSource health for this response.
Last updated on