Economic Calendar Search
GET/api/v1.0/quote/economic-calendar/searchSearch the economic calendar by keyword, supporting four types: economic data (CPI/GDP/non-farm payrolls and other macro indicators), market closures, economic events (central bank speeches/meetings), and corporate actions (dividends/splits). Returns matching event list with pagination and time sorting.
Parameters
| Name | Type | In | Required | Default | Description |
|---|---|---|---|---|---|
keyword | string | query | yes | — | Search keyword, e.g. CPI, Fed, GDP |
search_type | int | query | yes | — | Search type, see enum table below |
limit | int | query | no | 20 | Items per page, range 1~30 |
next_key | string | query | no | "" | Pagination cursor; leave empty for first page, pass previous pagination.next_key to continue |
time_order_type | int | query | no | 0 | Sort order: 0=ascending (ASC), 1=descending (DESC); only applies when search_type=2/3 |
search_type Enum
| Value | Meaning | Example Keywords |
|---|---|---|
| 1 | ECONOMIC_DATA — Macro economic data | CPI, GDP, non-farm, interest rate, employment |
| 2 | MARKET_CLOSE — Market closures | Christmas, National Day, New Year |
| 3 | ECONOMIC_EVENT — Economic events | Fed, central bank, Powell, FOMC |
| 4 | RIGHT_INTEREST — Corporate actions | Tencent, Apple, dividend |
Request Example
bash
curl -s "https://webapi.futunn.com/api/v1.0/quote/economic-calendar/search?search_type=3&limit=5&keyword=Fed" | jqResponse Fields
data is an array of objects; an empty result is []. Returns data[], each element is a matching event.
| Name | Type | Description |
|---|---|---|
data | object[] | |
data[].event_text | string | |
data[].previous | string | |
data[].predictive | string | |
data[].announce | string | |
data[].star | int | |
data[].event_time | int | |
data[].country | int | |
data[].currency | string | |
data[].unit | string | |
data[].unique_id | int | |
data[].detail_url | string | |
pagination | object | |
pagination.has_more | bool | |
pagination.next_key | string |
Supported Range
| Dimension | Supported | Notes |
|---|---|---|
| search_type=1 Economic data | Global macro indicators (CPI/GDP/PMI/rates/employment) | keyword is required and non-empty |
| search_type=2 Market closures | Market closure calendars for all markets | Supports time_order_type sorting |
| search_type=3 Economic events | Central bank speeches, rate meetings, policy releases | Supports time_order_type sorting |
| search_type=4 Corporate actions | Dividends/splits/rights issues/bonus shares | — |
Error Codes
| ret_code | error.code | Trigger Condition | Recommended Action |
|---|---|---|---|
| 0 | — | Success (includes empty list when keyword has no match) | Check data length to determine if data exists |
| -3 | invalid_parameter | Missing keyword or search_type / search_type not in 1~4 / limit out of range | Fix parameters and retry |
| -4 | internal_error | Service error | Retry; contact support if persistent |
Response Example
json
{
"ret_code": 0,
"ret_msg": "success",
"data": [
{}
],
"pagination": {
"has_more": true,
"next_key": "5"
}
}