From a question to a query.
Make your first discovery request and learn how to read the response.
1. Configure your environment
Request enterprise access to receive your deployment URL and access configuration. Keep these values in your server environment. The URL below is a placeholder; replace it with the endpoint supplied during onboarding.
export IMPLYRA_API_URL="https://your-rest-endpoint.example"Apply the network access or authentication instructions supplied for your deployment. The examples show the REST request shape and do not assume a universal public authentication header.
2. Discover your first markets
/markets/discoverRESTSelect volume, liquidity, and price. Add a 24-hour absolute price delta, then request the first 20 markets ranked by volume.
curl --fail-with-body \
-X POST "$IMPLYRA_API_URL/markets/discover" \
-H "Content-Type: application/json" \
-d '{
"metrics": [
"volume",
"liquidity",
"price"
],
"deltas": [
{
"metric": "price",
"window": "24h",
"compare": "delta_abs"
}
],
"sort": {
"metric": "volume",
"direction": "desc"
},
"pagination": {
"limit": 20
}
}'3. Read the response
The response contains markets and a pagination object. Price uses a 0–1 scale: 0.64 corresponds to 64%. A price delta of 0.04 is a change of four percentage points. The record below is illustrative.
{
"markets": [
{
"market_id": "example-market-id",
"condition_id": "example-condition-id",
"slug": "example-market",
"question": "Will the example event happen?",
"category": "Crypto",
"active": true,
"closed": false,
"age_seconds": 2592000,
"available_windows": [
"5m",
"15m",
"30m",
"1h",
"4h",
"24h",
"7d",
"30d"
],
"stage": "peak",
"price": 0.64,
"metrics": {
"volume": 1284512.33,
"liquidity": 391204.5,
"price": 0.64
},
"deltas": {
"price_24h": {
"abs": 0.04,
"status": "ok"
}
}
}
],
"pagination": {
"has_more": false
}
}4. Continue with the cursor
When pagination.has_more is true, pass pagination.next_cursor into the next request as pagination.cursor. Keep your filters and sort unchanged. Stop when has_more is false.
Check every delta status before displaying its value. A young market or a missing historical snapshot can leave a delta unavailable even when the current price is present.