# List Sports Filters

Retrieves available filter options for sports event contracts, including sport tags, competitions, and scopes. Use this to populate filter UI or discover available sports categories before querying series or events.

# OpenAPI definition

```json
{
  "info": {
    "title": "Webull Open API Reference",
    "description": "application.yml\\ncom\\ni18n\\nMETA-INF\\nstatic\\n\\r\\n",
    "contact": {
      "name": "",
      "url": "",
      "email": ""
    },
    "version": "2.0",
    "x-logo": {
      "url": "static/png/logo.png"
    }
  },
  "servers": [
    {
      "url": "https://us-global-openapi.uat.webullbroker.com"
    }
  ],
  "path": "/market-data/instruments/event-contracts/sports-filters/list",
  "method": "get",
  "tags": [
    "Instruments"
  ],
  "description": "Retrieves available filter options for sports event contracts, including sport tags, competitions, and scopes. Use this to populate filter UI or discover available sports categories before querying series or events.",
  "operationId": "sportsFilterUsingGET",
  "parameters": [
    {
      "name": "tag",
      "in": "query",
      "description": "tag name",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "Football"
    },
    {
      "name": "access_token",
      "in": "header",
      "description": "User's authenticated token.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "reqid",
      "in": "header",
      "description": "The unique ID for this request. Suggest using UUID.",
      "schema": {
        "type": "string"
      },
      "example": "2e46d5a4-bef9-4507-8cda-98f85d2f770c"
    }
  ],
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tag": {
                  "type": "string",
                  "description": "Tag name",
                  "example": "Basketball"
                },
                "competitions": {
                  "type": "array",
                  "description": "competition list",
                  "example": "College Football,Pro Football",
                  "items": {
                    "type": "object",
                    "properties": {
                      "competition": {
                        "type": "string",
                        "description": "Competition name (e.g., College Football, Pro Football).",
                        "example": "College Football"
                      },
                      "scopes": {
                        "type": "array",
                        "description": "scope list",
                        "example": "['Games', 'Futures','Awards']",
                        "items": {
                          "type": "string",
                          "description": "scope list",
                          "example": "['Games', 'Futures','Awards']"
                        }
                      }
                    },
                    "description": "Competition Information",
                    "example": "College Football,Pro Football",
                    "title": "Competition"
                  }
                },
                "scopes": {
                  "type": "array",
                  "description": "List of available scope categories under this tag (e.g., Games, Futures, Awards).",
                  "example": "['Games', 'Futures','Awards']",
                  "items": {
                    "type": "string",
                    "description": "List of available scope categories under this tag (e.g., Games, Futures, Awards).",
                    "example": "['Games', 'Futures','Awards']"
                  }
                }
              },
              "description": "Tag Information",
              "title": "EventTag"
            }
          }
        }
      }
    }
  },
  "postman": {
    "name": "List Sports Filters",
    "description": {
      "content": "Retrieves available filter options for sports event contracts, including sport tags, competitions, and scopes. Use this to populate filter UI or discover available sports categories before querying series or events.",
      "type": "text/plain"
    },
    "url": {
      "path": [
        "market-data",
        "instruments",
        "event-contracts",
        "sports-filters",
        "list"
      ],
      "host": [
        "{{baseUrl}}"
      ],
      "query": [
        {
          "disabled": false,
          "description": {
            "content": "tag name",
            "type": "text/plain"
          },
          "key": "tag",
          "value": ""
        }
      ],
      "variable": []
    },
    "header": [
      {
        "disabled": false,
        "description": {
          "content": "(Required) User's authenticated token.",
          "type": "text/plain"
        },
        "key": "access_token",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "The unique ID for this request. Suggest using UUID.",
          "type": "text/plain"
        },
        "key": "reqid",
        "value": ""
      },
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "method": "GET"
  }
}
```