# List Corporate Actions by Market

Retrieves corporate action events for all securities in a specified market within a date range. Use this endpoint to bulk-fetch events across the entire US market, rather than querying by individual symbol.

# 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://hk-co-branding-openapi.uat.webullbroker.com"
    }
  ],
  "path": "/market-data/instruments/stocks/corporate-actions/list-by-market",
  "method": "get",
  "tags": [
    "Corporate Actions"
  ],
  "description": "Retrieves corporate action events for all securities in a specified market within a date range. Use this endpoint to bulk-fetch events across the entire US market, rather than querying by individual symbol.",
  "operationId": "corpMarketUsingGET",
  "parameters": [
    {
      "name": "market",
      "in": "query",
      "description": "Currently only `US` (US Stock Market) is supported.",
      "required": true,
      "schema": {
        "type": "string"
      },
      "example": "US"
    },
    {
      "name": "start_date",
      "in": "query",
      "description": "Event start date, UTC time. Format: yyyy-MM-dd",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "2025-11-01"
    },
    {
      "name": "end_date",
      "in": "query",
      "description": "Event end date, UTC time. Format: yyyy-MM-dd",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "2025-12-31"
    },
    {
      "name": "event_types",
      "in": "query",
      "description": "Event type collection. Multiple event_types should be separated by ,",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "REVERSE_SPLIT,FORWARD_SPLIT"
    },
    {
      "name": "pagination_key",
      "in": "query",
      "description": "Pagination key returned from previous page response. Pass null or omit for first page.",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "eyJ2IjoxLCJwYWdlSW5kZXgiOjJ9"
    },
    {
      "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": "object",
            "properties": {
              "data": {
                "type": "array",
                "description": "Data list",
                "items": {
                  "type": "object",
                  "properties": {
                    "instrument_id": {
                      "type": "integer",
                      "description": "Security ID",
                      "format": "int32",
                      "example": 950175018
                    },
                    "symbol": {
                      "type": "string",
                      "description": "Security symbol, e.g., AAPL, GOOG.",
                      "example": "AAPL"
                    },
                    "exchange_code": {
                      "type": "string",
                      "description": "Exchange code, e.g., NAS, OTC.",
                      "example": "NAS"
                    },
                    "event_type": {
                      "type": "string",
                      "description": "Event type",
                      "example": "REVERSE_SPLIT",
                      "enum": [
                        "NAME_CHANGE",
                        "CASH_DIVIDEND",
                        "STOCK_DIVIDEND",
                        "REVERSE_SPLIT",
                        "FORWARD_SPLIT",
                        "SPIN_OFF",
                        "UNIT_SPLIT",
                        "MERGER",
                        "REDEMPTION"
                      ]
                    },
                    "event_action": {
                      "type": "string",
                      "description": "Event status, e.g., I(Insert, Valid)/U(Update, Valid)/C(Cancellation, invalid)/D(Deletion, invalid).",
                      "example": "I"
                    },
                    "event_id": {
                      "type": "integer",
                      "description": "Event id",
                      "format": "int32",
                      "example": 500051270
                    },
                    "source": {
                      "type": "string",
                      "description": "Event source, e.g., WEBULL_ARTIFICIAL(Webull artificial)",
                      "example": "WEBULL_ARTIFICIAL"
                    },
                    "ratio_old": {
                      "type": "string",
                      "description": "Old ratio, Before the change",
                      "example": "10"
                    },
                    "ratio_new": {
                      "type": "string",
                      "description": "New ratio, After the change, During the REVERSE_SPLIT process, when ratio_old is 10 and ratio_new is 5, it means that 10 shares are combined into 5.",
                      "example": "5"
                    },
                    "event_date": {
                      "type": "string",
                      "description": "Event date, UTC time, e.g: 2021-12-28",
                      "example": "2021-12-28"
                    },
                    "update_time": {
                      "type": "string",
                      "description": "Update time, UTC time, e.g: 2021-12-28T09:00:09.945+0000",
                      "example": "2021-12-28T09:00:09.945+0000"
                    },
                    "create_time": {
                      "type": "string",
                      "description": "Create time, UTC time, e.g: 2021-12-28T09:00:09.945+0000",
                      "example": "2021-12-28T09:00:09.945+0000"
                    }
                  },
                  "description": "Corporate Actions data response object",
                  "title": "CorpVo"
                }
              },
              "pagination_key": {
                "type": "string",
                "description": "Pagination key for next page. null means no more data.",
                "example": "eyJ2IjoxLCJwYWdlSW5kZXgiOjJ9"
              }
            },
            "title": "CorpVoPageResponse"
          }
        }
      }
    }
  },
  "postman": {
    "name": "List Corporate Actions by Market",
    "description": {
      "content": "Retrieves corporate action events for all securities in a specified market within a date range. Use this endpoint to bulk-fetch events across the entire US market, rather than querying by individual symbol.",
      "type": "text/plain"
    },
    "url": {
      "path": [
        "market-data",
        "instruments",
        "stocks",
        "corporate-actions",
        "list-by-market"
      ],
      "host": [
        "{{baseUrl}}"
      ],
      "query": [
        {
          "disabled": false,
          "description": {
            "content": "(Required) Currently only `US` (US Stock Market) is supported.",
            "type": "text/plain"
          },
          "key": "market",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "Event start date, UTC time. Format: yyyy-MM-dd",
            "type": "text/plain"
          },
          "key": "start_date",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "Event end date, UTC time. Format: yyyy-MM-dd",
            "type": "text/plain"
          },
          "key": "end_date",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "Event type collection. Multiple event_types should be separated by ,",
            "type": "text/plain"
          },
          "key": "event_types",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "Pagination key returned from previous page response. Pass null or omit for first page.",
            "type": "text/plain"
          },
          "key": "pagination_key",
          "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"
  }
}
```