1. Home
  2. Benzinga APIs
  3. Movers

Movers API Reference

Free Trial ➡

This REST API returns structured data for market movers.

API Endpoint
https://api.benzinga.com/api/v1/market
Response Content-Types

application/json

Schemes

https

Version

1.0.0

Authentication

token authentication

Type:
apiKey
Name:
apikey
In:
query

Playground

Endpoints

GET /movers

Returns market movers

Parameters

NameTypeLocationDescription
maxResultsintegerquery

Max numbers of gainers/losers to return. Limit 1000.

fromstring (YYYY-MM-DD)query

From session or timestamp.

  • yyyy-mm-dd
  • yyyy-mm-ddThh:mm:ii:ss
  • 1d, -1w, -1y, YTD
tostring (YYYY-MM-DD)query

To session or timestamp.

  • yyyy-mm-dd
  • yyyy-mm-ddThh:mm:ii:ss
sessionstring (REGULAR | PRE_MARKET | AFTER_MARKET)query

The market session to report for. PRE_MARKET and AFTER_MARKET will return movers only for the one session. Multi-day movers always use offical regular session closing prices. REGULAR is default.

screenerQuerystringquery

Filters movers by screener query. A screener query is a list of conditions separated by a semicolon. Some examples

  • marketcap_gt_1b
  • close_gt_5
  • sector_in_technology,healthcare
  • marketcap_gt_300m;marketcap_lt_2b

Responses

CodeModelDescription
200 OKmovers

success

Response (200 OK)

{
  "processingTimeMillis": "integer",
  "result": {
    "fromDate": "string (Mon Jun 22 2020 20:00:00 GMT+0000 (Coordinated Universal Time))",
    "toDate": "string (Mon Jun 22 2020 20:00:00 GMT+0000 (Coordinated Universal Time))",
    "snapTo": "string (Snap id=1140563,date=2020-06-23T19:59:00.000Z)",
    "usePreviousClose": "boolean",
    "gainers": [
      {
        "symbol": "string",
        "change": "number (double)",
        "changePercent": "number (double)",
        "volume": "number (double)",
        "close": "number (double)",
        "companyName": "string",
        "averageVolume": "integer",
        "previousClose": "number (double)"
      }
    ],
    "losers": [
      {
        "symbol": "string",
        "change": "number (double)",
        "changePercent": "number (double)",
        "volume": "number (double)",
        "close": "number (double)",
        "companyName": "string",
        "averageVolume": "integer",
        "previousClose": "number (double)"
      }
    ]
  }
}
token

Models

movers: object

PropertyTypeDescription
processingTimeMillisinteger

Informational. The number of milliseconds processing time took on the server.

resultobject-
result.fromDatestring (Mon Jun 22 2020 20:00:00 GMT+0000 (Coordinated Universal Time))

Datetime of the start of the period used to calculate movers.

result.toDatestring (Mon Jun 22 2020 20:00:00 GMT+0000 (Coordinated Universal Time))

Datetime of the end of the period used to calculate movers.

result.snapTostring (Snap id=1140563,date=2020-06-23T19:59:00.000Z)-
result.usePreviousCloseboolean

True if the previous regular session close is being used to calcuated price change fields.

result.gainersobject[]-
result.losersobject[]-
Structure (JSON)
{
  "processingTimeMillis": "integer",
  "result": {
    "fromDate": "string (Mon Jun 22 2020 20:00:00 GMT+0000 (Coordinated Universal Time))",
    "toDate": "string (Mon Jun 22 2020 20:00:00 GMT+0000 (Coordinated Universal Time))",
    "snapTo": "string (Snap id=1140563,date=2020-06-23T19:59:00.000Z)",
    "usePreviousClose": "boolean",
    "gainers": [
      {
        "symbol": "string",
        "change": "number (double)",
        "changePercent": "number (double)",
        "volume": "number (double)",
        "close": "number (double)",
        "companyName": "string",
        "averageVolume": "integer",
        "previousClose": "number (double)"
      }
    ],
    "losers": [
      {
        "symbol": "string",
        "change": "number (double)",
        "changePercent": "number (double)",
        "volume": "number (double)",
        "close": "number (double)",
        "companyName": "string",
        "averageVolume": "integer",
        "previousClose": "number (double)"
      }
    ]
  }
}

movers_item: object

PropertyTypeDescription
symbolstring

Ticker Symbol (F, MSFT, etc...)

changenumber (double)

Price change

changePercentnumber (double)

Price change percent

volumenumber (double)

Volume for the instrument over the report period.

closenumber (double)

The last known price (up to a minute delayed if in an active session) of the instrument.

companyNamestring

Company name

averageVolumeinteger

Average 50 date volume for the instrument

previousClosenumber (double)

Previous close price

Structure (JSON)
{
  "symbol": "string",
  "change": "number (double)",
  "changePercent": "number (double)",
  "volume": "number (double)",
  "close": "number (double)",
  "companyName": "string",
  "averageVolume": "integer",
  "previousClose": "number (double)"
}