v1

latestOpenAPI 3.1.0UNLICENSED2026-07-26216788.0 KB

Markets

GetMarketIdByName

Resolves an asset/quote symbol pair to its numeric market ID. asset_symbol is required and fails with INVALID_ARGUMENT if blank; an unknown asset/quote combination returns NOT_FOUND.

post/market_service.v1.MarketService/GetMarketIdByName

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol. If omitted, use 1.

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

assetSymbolstring required

Underlying asset symbol, e.g. "BTC". Matched case-insensitively and trimmed.

quoteSymbolstring nullable

Quote symbol, e.g. "PERP". Optional, but omitting it looks up a market named exactly by assetSymbol alone (e.g. "BTC") rather than "BTC-PERP", which may not resolve to any real market.

Response

Success

marketIdstring int64

Resolved on-chain market identifier.