Stocks Ticker Snapshot

Single ticker snapshot (trade/quote/min/day/prevDay).

Endpoint Details

HTTP Method	`GET`
Path	`/v2/snapshot/locale/us/markets/stocks/tickers/{stocksTicker}`
Version	v2
Minimum Plan	free

Path Parameters

Parameter	Required	Description	Example
`stocksTicker`	Required	The stock ticker symbol (e.g., AAPL, MSFT)	`AAPL`

Query Parameters

Parameter	Type	Required	Description
`api_key`	string	Required	Your API key for authentication
`limit`	integer	Optional	Maximum number of results to return
`sort`	string	Optional	Sort order (asc or desc)

Example Request

curl "https://mail.tradeiqai.com/api/v2/snapshot/locale/us/markets/stocks/tickers/AAPL?api_key=YOUR_API_KEY"

Note: Replace YOUR_API_KEY with your actual API key.

Response Attributes

Attribute	Type	Description
`ok`	boolean	Indicates if the request was successful (e.g., 1)
`data`	object	Response data object
`data.status`	string	Response status (typically "OK") (e.g., OK)
`data.results`	object	Array or object containing the endpoint-specific data
`data.results.ticker`	object
`data.results.ticker.properties`	unknown
`data.results.status`	string	String value (e.g., OK)
`data.results.request_id`	string	String value (e.g., e0c731c71d90c707daa690d03a395cb2)

Example Response

{
    "ok": true,
    "data": {
        "status": "OK",
        "ticker": {
            "ticker": "AAPL",
            "todaysChangePerc": -1.3902851537394678160808325628750026226043701171875,
            "todaysChange": -4.1100999999999885403667576611042022705078125,
            "updated": 1781308800000000000,
            "day": {
                "dv": "38959758.272697",
                "o": 296.029999999999972715158946812152862548828125,
                "h": 297.1399999999999863575794734060764312744140625,
                "l": 289.6200000000000045474735088646411895751953125,
                "c": 291.1299999999999954525264911353588104248046875,
                "v": 38959758,
                "vw": 291.598799999999982901499606668949127197265625
            },
            "lastQuote": {
                "P": 291.57999999999998408384271897375583648681640625,
                "S": 40,
                "p": 291.51999999999998181010596454143524169921875,
                "s": 80,
                "t": 1781308794621369371
            },
            "lastTrade": {
                "c": [
                    12
                ],
                "i": "431541",
                "p": 291.519900000000006912159733474254608154296875,
                "s": 66,
                "t": 1781308790916544569,
                "x": 4,
                "ds": "66.0"
            },
            "min": {
                "dv": "497.0",
                "dav": "38959758.272697",
                "av": 38959758,
                "t": 1781308740000,
                "n": 24,
                "o": 291.51010000000002264641807414591312408447265625,
                "h": 291.51999999999998181010596454143524169921875,
                "l": 291.509999999999990905052982270717620849609375,
                "c": 291.519900000000006912159733474254608154296875,
                "v": 497,
                "vw": 291.5167000000000143700162880122661590576171875
            },
            "prevDay": {
                "o": 293.720000000000027284841053187847137451171875,
                "h": 297,
                "l": 289.58999999999997498889570124447345733642578125,
                "c": 295.6299999999999954525264911353588104248046875,
                "v": 42572497.853978000581264495849609375,
                "vw": 294.114100000000007639755494892597198486328125
            }
        },
        "results": {
            "ticker": {
                "ticker": "AAPL",
                "todaysChangePerc": -1.3902851537394678160808325628750026226043701171875,
                "todaysChange": -4.1100999999999885403667576611042022705078125,
                "updated": 1781308800000000000,
                "day": {
                    "dv": "38959758.272697",
                    "o": 296.029999999999972715158946812152862548828125,
                    "h": 297.1399999999999863575794734060764312744140625,
                    "l": 289.6200000000000045474735088646411895751953125,
                    "c": 291.1299999999999954525264911353588104248046875,
                    "v": 38959758,
                    "vw": 291.598799999999982901499606668949127197265625
                },
                "lastQuote": {
                    "P": 291.57999999999998408384271897375583648681640625,
                    "S": 40,
                    "p": 291.51999999999998181010596454143524169921875,
                    "s": 80,
                    "t": 1781308794621369371
                },
                "lastTrade": {
                    "c": [
                        12
                    ],
                    "i": "431541",
                    "p": 291.519900000000006912159733474254608154296875,
                    "s": 66,
                    "t": 1781308790916544569,
                    "x": 4,
                    "ds": "66.0"
                },
                "min": {
                    "dv": "497.0",
                    "dav": "38959758.272697",
                    "av": 38959758,
                    "t": 1781308740000,
                    "n": 24,
                    "o": 291.51010000000002264641807414591312408447265625,
                    "h": 291.51999999999998181010596454143524169921875,
                    "l": 291.509999999999990905052982270717620849609375,
                    "c": 291.519900000000006912159733474254608154296875,
                    "v": 497,
                    "vw": 291.5167000000000143700162880122661590576171875
                },
                "prevDay": {
                    "o": 293.720000000000027284841053187847137451171875,
                    "h": 297,
                    "l": 289.58999999999997498889570124447345733642578125,
                    "c": 295.6299999999999954525264911353588104248046875,
                    "v": 42572497.853978000581264495849609375,
                    "vw": 294.114100000000007639755494892597198486328125
                }
            },
            "status": "OK",
            "request_id": "e0c731c71d90c707daa690d03a395cb2"
        }
    }
}

← Stocks Full Market Snapshot Back to Documentation Stocks Last Quote →