Premarket Movers API Reference

This REST API returns structured data for market movers.

API Endpoint
https://tradeforme.money/api/v1/movers/

Response Content-Types
application/json

Schemes
https

Version
1.0.0

Authentication

Bearer/token authentication

Trade-For-Me-Authorization: Bearer <token>

Endpoints

GET /movers

Parameters

Parameter	Type	Description
volMin	integer	Minimum amount of trading volume
priceRange	string	Stock price range. Min required. Ex: 1.25-300
changeRange	string	Net change. Min required. Ex: 1-1.5
floatRange	string	Range in million or billion shares. Min. required. Max optional Decimals allowed. Ex: 10M-100.5M
marketCapRange	string	Range in million or billion shares. Min. required. Max optional Decimals allowed. Ex: 50B-100B
maxResults	integer	Max number of results to return.
direction	string	up = gainers, down = losers

Responses

Code	Model	Description
200 OK	movers	success

Example cURL Request

curl --location 'https://tradeforme.money/api/v1/movers/?volMin=100&
     priceRange=1-1000&
     changeRange=.10&
     floatRange=1M-500B&
     marketCapRange=1M-500B&
     maxResults=10&
     direction=up' \
--header 'Trade-For-Me-Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXXX'

Response (200 OK)

{
    "status": "integer",
    "message": "string",
    "data": {
        "movers": [
            {
                "createdDate": "string (2023-01-24 09:59:02)",
                "symbol": "string",
                "price": "number (double)",
                "close": "number (double)",
                "previousClose": "number (double)",
                "change": "number (double)",
                "changePercent": "number (double)",
                "direction": "string",
                "description": "string",
                "volume": "integer",
                "averageVolume": "integer",
                "marketCap": "integer",
                "shareFloat": "integer"
            }
        ]
    }
}