Get market profile

Read canonical market context for one supported instrument.

Use pair_address when available. Liquidity context is included when current backing can supply it.

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

Access

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

Handles

Surface	Label	Value
`mcp`	MCP	`market.resolve_market`
`rest`	REST	`GET /v1/market/market-profile`
`skill`	Skill	`market.resolve_market`

Availability

DEX market profile coverage is Available. Unsupported CEX paths return explicit errors.

Request example


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

Try send

Try market 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.

API key (optional)Request pathGET

Response example


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

Request fields

Query parameters

Field	Type	Required	Notes
`market_kind`	`string`	Required	Market family. Use `dex` for now.
`chain`	`string`	Required	Chain key. Prefer the current EVM family such as `ethereum` or `base`; use `solana` only for the separate Beta lane.
`address`	`string`	Required	Token, market, or pool address.

Response fields

Market profile

Field	Type	Notes
`market_profile.market_kind`	`string`	Market family.
`market_profile.chain`	`string`	Market chain.
`market_profile.address`	`string`	Market address.
`market_profile.symbol`	`string`	Market symbol.
`market_profile.display_name`	`string`	Display name.
`market_profile.source_id`	`string`	Backing source id.

Response metadata

Field	Type	Notes
`freshness_ms`	`number`	Data age in milliseconds.
`source_status`	`string`	Source health for this response.