title: Get market profile description: Read market context for one supported instrument through AgentQL Market API.

Get market profile

Name: AgentQL
Brand: AgentQL

Read market context for one supported instrument.

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

Back to Market API

Access

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

Handles

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

Contract notes

Prefer pair_address for explicit DEX market identity whenever it is available.
When pair_address is present, it is treated as the primary lookup key for the current request.
See Parameter Contracts for shared validation rules.
Zero-address inputs such as 0x0000000000000000000000000000000000000000 and shorthand forms such as 0x0 are rejected.
Failed responses return machine-readable error.code plus both trace_id and request_id for support and retry diagnostics.

Request example


GET {GATEWAY_BASE_URL}/v1/market/market-profile?market_kind=dex&chain=ethereum&pair_address=0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8

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 (sent as header)Request pathGET

Response example


{
  "market_profile": {
    "market_kind": "dex",
    "chain": "ethereum",
    "address": "0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8",
    "symbol": "WETH/USDC",
    "display_name": "WETH / USDC",
    "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. Use an enabled EVM chain such as `ethereum` or `base`.
`pair_address`	`string`	Optional	Preferred market identifier for DEX lookups. Send the full 20-byte canonical `0x...` pair contract address when you have it.
`address`	`string`	Optional	Secondary lookup input. Send the full 20-byte canonical `0x...` token contract address only when `pair_address` is unavailable.

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.