Search events, markets, and categories
/api/v1/searchTypo-tolerant search over currently tradable AGARA event titles/slugs and market questions/slugs, plus category labels/slugs. Event and market matches include a comparable 0–1 relevance score; indirect category matches score 0. Each event arrives with its markets and their outcome prices — the same shape the events listing returns — so a result can be rendered without a follow-up request. Markets carry their leading outcomes (label + odds) and order-acceptance status. A category-name query also fans out that category’s highest-volume tradable AGARA events.
Query Parameters
Search text. Minimum 2 characters.
2 <= length <= 128Max results per list (events, markets). Default 10, max 25.
1 <= value <= 2510Filter catalogue results to the AGARA exchange.
"AGARA"Value in
- "AGARA"
Response Body
application/json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1/search?q=string"{ "events": [ { "relevance_score": 0, "event_type": "GAME", "market_count": 0, "display": { "image_url": "string", "banner_url": "string", "icon_url": "string", "description": "string", "subtext": "string", "display_date": "string", "liquidity": 0, "has_three_way_markets": true, "has_prop_markets": true, "has_legacy_prop_markets": true, "market_categories": [ "string" ], "tags": [ "string" ], "resolution_source": "string", "layout": "regular", "game_unit_label": "Game", "spreads_main_market_id": "string", "totals_main_market_id": "string", "agara_cms": { "property1": null, "property2": null }, "team_a": { "name": "string", "abbreviation": "string", "logo_url": "string", "color": "string", "record": "string", "sport_slug": "string", "league_slug": "string", "provider_id": "string", "source_team_id": "string" }, "team_b": { "name": "string", "abbreviation": "string", "logo_url": "string", "color": "string", "record": "string", "sport_slug": "string", "league_slug": "string", "provider_id": "string", "source_team_id": "string" }, "sport_slug": "string", "league_slug": "string", "format_label": "string", "spreads_main_line": 0, "totals_main_line": 0 }, "game_state": { "id": 0, "score": { "sport": "tennis", "match": { "a": 0, "b": 0 }, "sets": [ { "a": 0, "b": 0, "tiebreak": { "a": 0, "b": 0 } } ] }, "match": { "lifecycle": "scheduled", "live_label": "string" } }, "id": "string", "slug": "string", "title": "string", "is_accepting_orders": true, "is_live": true, "is_group_root": true, "start_time": "string", "end_time": "string", "volume_micro": "string", "primary_category": { "slug": "string", "label": "string" }, "main_market_id": "string", "resolution_status": "ACTIVE", "state": "DRAFT", "main_market_group": { "neg_risk_id": "string", "markets": [ { "id": "string", "state": "DRAFT", "exchange": "AGARA", "slug": "string", "question": "string", "display_type": "BINARY", "source_market_type": "string", "outcomes": [ { "id": "string", "index": 0, "label": "string", "price_micro": "string", "token_id": "string", "best_bid_micro": "string", "best_ask_micro": "string", "spread_micro": "string", "kind": "team_home", "short_label": "string", "team_side": "home", "side": "left", "threshold": 0, "resolution_price_micro": "string", "bet_slip_title": "string", "resolution_label": "string", "display": { "label": "string", "kind": "team_home", "short_label": "string", "team_side": "home", "side": "left", "threshold": 0, "bet_slip_title": "string", "resolution_label": "string", "agara_cms": { "property1": null, "property2": null } } } ], "is_accepting_orders": true, "halted_at": "string", "halted_reason": "string", "volume_micro": "string", "liquidity": "string", "volume_24h_micro": "string", "tick_size_micro": "string", "engine_config": { "tick_size": 0, "price_scale": 0, "size_scale": 0, "min_price": 0, "max_price": 0 }, "min_order_size_micro": "string", "line": "string", "resolution_status": "DISPUTED", "resolution_outcome": "string", "resolved_at": "string", "resolution": { "source": "string", "reference_value": "string", "observed_value": "string", "observed_at": "string" }, "archived_at": "string", "condition_id": "string", "neg_risk_id": "string", "three_way_role": "home", "is_three_way": true, "game_number": 0, "display_label": "string", "lp_incentive": { "pool_micro": "string", "max_spread_micro": 0, "min_shares_micro": "string" }, "display": { "image_url": "string", "portfolio_title": "string", "description": "string", "resolution_source": "string", "resolution_criteria": "string", "resolution_sources": [ { "title": "string", "url": "string" } ], "player_name": "string", "stat_type": "string", "liquidity": 0, "cadence_seconds": 0, "series_color": "string", "reference_price": "string", "currency": "string", "reference_at": "string", "observe_at": "string", "band_index": 0, "band_lower": "string", "band_upper": "string", "band_label": "string", "pyth_feed_id": "string", "pyth_benchmark_symbol": "string", "tradingview_symbol": "string", "pyth_pro_symbol": "string", "security_symbol": "string", "security_provider": "string", "game_number": 0, "is_three_way": true, "three_way_role": "home", "display_label": "string", "agara_cms": { "property1": null, "property2": null } } } ] } } ], "markets": [ { "relevance_score": 0, "id": "string", "slug": "string", "question": "string", "is_accepting_orders": true, "volume_micro": "string", "event": { "slug": "string", "title": "string", "image_url": "string" }, "outcomes": [ { "label": "string", "price_micro": "string" } ] } ], "categories": [ { "slug": "string", "label": "string", "icon": "string" } ]}Ranked market outcome price/probability histories POST
Ranks AGARA outcome tokens with recorded trade-price history by last traded price, highest first. Tokens without history are omitted; a recorded zero price is eligible. Equal prices retain request order. Each returned history ends at the same last traded price used for ranking.
Home category shelves GET
The homepage's category shelves in display order, each with up to six of the category's events, highest all-time trading volume first (markets still open included). Items use the events listing shape (EventListItem) with listing_markets. Ended events and events with nothing left to trade are left out, and so is a category with no events left.