# List Top Actives
• Function description: Stock Top Active Rank. Most actively traded stocks ranked by volume, relative volume, turnover, turnover rate, or amplitude. The relative_volume_10d field is unique to the Top Active response compared to the Gainers/Losers endpoint. Returns top 200 results without pagination.
• Frequency limit: Market-data interfaces rate limit is 600 requests per minute.
# OpenAPI definition
```json
{
"info": {
"title": "Webull OpenAPI Documentation",
"description": "The Webull OpenAPI enables integration of trading APIs, market data for building trading applications and brokerage solutions. It supports HTTP-based historical and real-time market data and MQTT streaming via WebSocket/TCP, along with SDKs, secure authentication, and APIs for orders, accounts, and event contract trading.",
"contact": {
"name": "Webull Developer Support",
"url": "https://www.webull.hk/en/help",
"email": "webull-api-support@webull.com"
},
"version": "2.0",
"x-logo": {
"url": "static/png/logo.png"
}
},
"servers": [
{
"url": "https://api.sandbox.webull.hk"
}
],
"path": "/market-data/screeners/top-actives/list",
"method": "get",
"tags": [
"Screeners"
],
"description": "• Function description: Stock Top Active Rank. Most actively traded stocks ranked by volume, relative volume, turnover, turnover rate, or amplitude. The relative_volume_10d field is unique to the Top Active response compared to the Gainers/Losers endpoint. Returns top 200 results without pagination.
• Frequency limit: Market-data interfaces rate limit is 600 requests per minute.",
"operationId": "getTopActive",
"parameters": [
{
"name": "category",
"in": "query",
"description": "Security market category. Default: US_STOCK.",
"required": true,
"schema": {
"type": "string",
"enum": [
"US_STOCK"
]
},
"example": "US_STOCK"
},
{
"name": "rank_type",
"in": "query",
"description": "Ranking dimension that determines which activity metric is used for filtering. Default: VOLUME.",
"required": false,
"schema": {
"type": "string",
"description": "Rank type for most active screener. Activity metric for ranking.",
"enum": [
"VOLUME",
"RELATIVE_VOLUME_10D",
"TURNOVER",
"TURNOVER_RATE",
"AMPLITUDE"
]
},
"example": "VOLUME"
},
{
"name": "sort_by",
"in": "query",
"description": "Secondary sort field for further ordering within the ranking. Default: VOLUME.",
"required": false,
"schema": {
"type": "string",
"description": "Secondary sort field for screener API.",
"enum": [
"CHANGE_RATIO",
"RELATIVE_VOLUME_10D",
"MARKET_VALUE",
"CLOSE",
"PRICE",
"PE_TTM",
"HIGH",
"LOW",
"AMPLITUDE",
"TURNOVER",
"VOLUME"
]
},
"example": "VOLUME"
},
{
"name": "direction",
"in": "query",
"description": "Sort direction. Default: DESC.",
"required": false,
"schema": {
"type": "string",
"description": "Sort direction for screener API.",
"enum": [
"ASC",
"DESC"
]
},
"example": "DESC"
},
{
"name": "x-app-key",
"in": "header",
"description": "A unique identifier issued to a developer for accessing an application's API.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-app-secret",
"in": "header",
"description": "A unique key issued to developers to access the application's API.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-timestamp",
"in": "header",
"description": "Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-signature-version",
"in": "header",
"description": "Signature algorithm version, default is 1.0.",
"required": true,
"schema": {
"type": "string",
"default": "1.0"
},
"examples": {
"1.0": {
"value": "1.0"
}
}
},
{
"name": "x-signature-algorithm",
"in": "header",
"description": "Signature algorithm, default is HMAC-SHA1.",
"required": true,
"schema": {
"type": "string",
"default": "HMAC-SHA1"
},
"examples": {
"HMAC-SHA1": {
"value": "HMAC-SHA1"
}
}
},
{
"name": "x-signature-nonce",
"in": "header",
"description": "Signature unique random number.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-access-token",
"in": "header",
"description": "An access token is a credential that represents the authorization granted to a client (e.g., a user or an application) to access specific protected resources on behalf of a user, without needing to share their password.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-version",
"in": "header",
"description": "API interface version. Supported values: `v2`, `v3`.",
"required": true,
"schema": {
"type": "string",
"default": "v3"
},
"examples": {
"v3": {
"value": "v3"
}
}
},
{
"name": "x-signature",
"in": "header",
"description": "A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "object",
"properties": {
"instrument_id": {
"type": "string",
"description": "Unique identifier of the tradable instrument",
"example": "913256135"
},
"symbol": {
"type": "string",
"description": "Trading symbol of the financial instrument",
"example": "00700"
},
"name": {
"type": "string",
"description": "Full name of the instrument",
"example": "Tencent Holdings Ltd."
},
"exchange_code": {
"type": "string",
"description": "Standardized exchange code",
"example": "HKEX"
},
"currency_code": {
"type": "string",
"description": "Denomination currency of the instrument (ISO 4217)",
"example": "HKD"
},
"pre_close": {
"type": "string",
"description": "Previous trading day's closing price",
"example": "380.2"
},
"open": {
"type": "string",
"description": "Opening price for the current trading day",
"example": "382.0"
},
"high": {
"type": "string",
"description": "Intraday high price for the current trading day",
"example": "388.6"
},
"low": {
"type": "string",
"description": "Intraday low price for the current trading day",
"example": "380.0"
},
"close": {
"type": "string",
"description": "Latest traded price for the current trading day",
"example": "385.6"
},
"price": {
"type": "string",
"description": "Most recent quoted price within the selected time interval (pre market / post market / intraday)",
"example": "385.6"
},
"change": {
"type": "string",
"description": "Absolute price change within the selected time interval. Returns pre/post market change when in extended hours",
"example": "5.4"
},
"change_ratio": {
"type": "string",
"description": "Price change percentage within the selected time interval (decimal ratio). Returns pre/post market change percentage when in extended hours",
"example": "0.0142"
},
"volume": {
"type": "string",
"description": "Cumulative traded volume for the current day (in shares)",
"example": "12345678"
},
"turnover": {
"type": "string",
"description": "Cumulative turnover amount in denomination currency",
"example": "4756789012"
},
"turnover_rate": {
"type": "string",
"description": "Turnover rate as a decimal ratio (e.g. 0.05 represents 5%)",
"example": "0.0013"
},
"market_value": {
"type": "string",
"description": "Total market capitalization in denomination currency",
"example": "3650000000000"
},
"amplitude": {
"type": "string",
"description": "Price amplitude ((high - low) / pre_close) as a decimal ratio",
"example": "0.0226"
},
"relative_volume_10d": {
"type": "string",
"description": "Relative volume (current day volume / 10 day average volume)",
"example": "11.91"
}
},
"description": "Stock information from most active screener API. Contains additional relative_volume_10d field compared to gainers/losers.",
"title": "MostActiveStockVo"
}
}
}
}
},
"401": {
"description": "Unauthorized: Authentication required",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "UNAUTHORIZED"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Insufficient permission"
}
}
}
}
}
},
"417": {
"description": "A business logic error triggered when the request cannot be processed due to domain-specific constraints.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "INVALID_PARAMETER"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Parameter error, phone"
}
}
}
}
}
},
"500": {
"description": "Internal Server Error.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "SYSTEM_ERROR"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Internal Server Error"
}
}
}
}
}
}
},
"postman": {
"name": "List Top Actives",
"description": {
"content": "• Function description: Stock Top Active Rank. Most actively traded stocks ranked by volume, relative volume, turnover, turnover rate, or amplitude. The relative_volume_10d field is unique to the Top Active response compared to the Gainers/Losers endpoint. Returns top 200 results without pagination.
• Frequency limit: Market-data interfaces rate limit is 600 requests per minute.",
"type": "text/plain"
},
"url": {
"path": [
"market-data",
"screeners",
"top-actives",
"list"
],
"host": [
"{{baseUrl}}"
],
"query": [
{
"disabled": false,
"description": {
"content": "(Required) Security market category. Default: US_STOCK.",
"type": "text/plain"
},
"key": "category",
"value": ""
},
{
"disabled": false,
"description": {
"content": "Ranking dimension that determines which activity metric is used for filtering. Default: VOLUME.",
"type": "text/plain"
},
"key": "rank_type",
"value": ""
},
{
"disabled": false,
"description": {
"content": "Secondary sort field for further ordering within the ranking. Default: VOLUME.",
"type": "text/plain"
},
"key": "sort_by",
"value": ""
},
{
"disabled": false,
"description": {
"content": "Sort direction. Default: DESC.",
"type": "text/plain"
},
"key": "direction",
"value": ""
}
],
"variable": []
},
"header": [
{
"disabled": false,
"description": {
"content": "(Required) A unique identifier issued to a developer for accessing an application's API.",
"type": "text/plain"
},
"key": "x-app-key",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) A unique key issued to developers to access the application's API.",
"type": "text/plain"
},
"key": "x-app-secret",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.",
"type": "text/plain"
},
"key": "x-timestamp",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature algorithm version, default is 1.0.",
"type": "text/plain"
},
"key": "x-signature-version",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature algorithm, default is HMAC-SHA1.",
"type": "text/plain"
},
"key": "x-signature-algorithm",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature unique random number.",
"type": "text/plain"
},
"key": "x-signature-nonce",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) An access token is a credential that represents the authorization granted to a client (e.g., a user or an application) to access specific protected resources on behalf of a user, without needing to share their password.",
"type": "text/plain"
},
"key": "x-access-token",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) API interface version. Supported values: `v2`, `v3`.",
"type": "text/plain"
},
"key": "x-version",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.",
"type": "text/plain"
},
"key": "x-signature",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "GET"
}
}
```