Skip to main content

Tick-by-Tick

The market data request is not supported via Webull OpenAPI at the moment. Please keep tuned.

Interface Description

  • Function description:

    • Query tick-by-tick transaction of securities according to the stock code list.
  • Request URL: /market-data/tick

  • Request method: Establish a GRPC through the Webull SDK to establish a persistent connection, and then call the interface to obtain it.

  • Frequency limit: The calling frequency of each App ID is limited to one time per second.

Request Parameters

ParameterTypeRequired fieldsDescription
symbolStringYesexample: single:AAPL
categoryStringYesSecurity type. Reference: Category, such as: US_STOCK
countStringYesThe number of lines: the default is 30, and the maximum limit is 1000

Response Parameter

FieldTypeDescription
symbolStringSecurities code
instrument_idStringUnique identifier for the security
result[]TickTick-by-Tick transaction

Tick

FieldTypeDescription
timeStringFilled time
priceStringPrice
volumestringFilled Volume
sidestringTrade direction, details please refer here Direction

Request Example

from webullsdktrade.grpc_api import API
from webullsdkquotescore.grpc.grpc_client import GrpcApiClient
from webullsdkcore.common.region import Region

grpc_client = GrpcApiClient(your_app_key, your_app_secret, Region.US.value)
api = API(grpc_client)
response = api.market_data.get_tick(symbol, category)
if response.status_code == 200:
result = response.json()

Response Example

{
"symbol":"AAPL",
"instrumentId":"913256409",
"result":[
{
"time":"1669882089000",
"price":"294.400",
"volume":"300",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"20000",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"5100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"200",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"23600",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"400",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"200",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"1700",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"400",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"200",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"700",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"300",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"200",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"10000",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"500",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"200",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"100",
"side":"N"
},
{
"time":"1669882089000",
"price":"294.400",
"volume":"1000",
"side":"N"
}
]
}