Search events, markets, and categories

Typo-tolerant search over currently tradable AGARA event titles/slugs and market questions/slugs, plus category labels/slugs. Events and markets carry their leading outcomes (label + odds) and order-acceptance status; events carry their top-level category. A category-name query also fans out that category’s highest-volume tradable AGARA events.

GET

/api/v1/search

Query Parameters

`q`
Required
string

Search text. Minimum 2 characters.

Minimum length: 2Maximum length: 128

`limit`integer

Max results per list (events, markets). Default 10, max 25.

Default: 10Minimum: 1Maximum: 25

`source`string

Filter catalogue results to the AGARA exchange.

Default: "AGARA"Value in: "AGARA"

curl -X GET "https://app.agara.xyz/api/v1/search?q=string&limit=10&source=AGARA"

Success

{
  "events": [
    {
      "id": "string",
      "slug": "string",
      "title": "string",
      "type": "GAME",
      "is_accepting_orders": true,
      "image_url": "string",
      "volume_micro": "string",
      "category": {
        "slug": "string",
        "label": "string"
      },
      "outcomes": [
        {
          "label": "string",
          "price_micro": "string"
        }
      ]
    }
  ],
  "markets": [
    {
      "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"
    }
  ]
}

Search events, markets, and categories

Query Parameters

qRequiredstring

limitinteger

sourcestring

Response

TypeScript

`q`
Required
string

`limit`integer

`source`string