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.
Right-rail quick trades GET
Composed shelf: a fixed BTC 5-minute up/down market plus 0-2 sports cards (live preferred, upcoming as fallback).