Skip to main content
GET
/
api
/
v1
/
markets
/
search
Search markets
curl --request GET \
  --url https://api.allium.so/api/v1/markets/search \
  --header 'X-API-KEY: <api-key>'
{
  "items": [
    {
      "market_id": "<string>",
      "venue": "<string>"
    }
  ]
}
Alpha — The Market Data API is in alpha. Schema and response format may change. To request access, contact us or reach out to your account manager.
Ranked free-text search across markets. Useful for ticker lookups and disambiguating a symbol that trades across multiple venues and instrument types. match_type indicates which field matched the query.

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
q
string
required

Search query (max 1024 chars).

Maximum string length: 1024
​
limit
integer
default:20

Maximum results to return (1–100).

Required range: 1 <= x <= 100

Response

200 - application/json

Ranked search results.

​
items
object[]
required