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., 89e72140dc69c4dccc8df5d60743e57d)

Example Response

{
    "ok": true,
    "data": {
        "status": "OK",
        "ticker": {
            "ticker": "AAPL",
            "todaysChangePerc": -0.947820668393966503373349041794426739215850830078125,
            "todaysChange": -2.89000000000004320099833421409130096435546875,
            "updated": 1786569739534723728,
            "day": {
                "dv": "42791545.505673",
                "o": 305.1000000000000227373675443232059478759765625,
                "h": 305.66000000000002501110429875552654266357421875,
                "l": 300.56999999999999317878973670303821563720703125,
                "c": 302.25,
                "v": 42791545,
                "vw": 302.29790000000002692104317247867584228515625
            },
            "lastQuote": {
                "P": 302.23000000000001818989403545856475830078125,
                "S": 40,
                "p": 302.01999999999998181010596454143524169921875,
                "s": 40,
                "t": 1786569719220204206
            },
            "lastTrade": {
                "c": [
                    12
                ],
                "i": "477415",
                "p": 302.01999999999998181010596454143524169921875,
                "s": 100,
                "t": 1786569739534723728,
                "x": 4,
                "ds": "100.0"
            },
            "min": {
                "dv": "12011.055938",
                "dav": "42791545.505673",
                "av": 42791545,
                "t": 1786569660000,
                "n": 100,
                "o": 302.08999999999997498889570124447345733642578125,
                "h": 302.220000000000027284841053187847137451171875,
                "l": 302.08999999999997498889570124447345733642578125,
                "c": 302.19999999999998863131622783839702606201171875,
                "v": 12011,
                "vw": 302.15870000000001027729013003408908843994140625
            },
            "prevDay": {
                "o": 307.75,
                "h": 309.970000000000027284841053187847137451171875,
                "l": 302.79000000000002046363078989088535308837890625,
                "c": 304.91000000000002501110429875552654266357421875,
                "v": 37476746.31650499999523162841796875,
                "vw": 305.66059999999998808561940677464008331298828125
            }
        },
        "results": {
            "ticker": {
                "ticker": "AAPL",
                "todaysChangePerc": -0.947820668393966503373349041794426739215850830078125,
                "todaysChange": -2.89000000000004320099833421409130096435546875,
                "updated": 1786569739534723728,
                "day": {
                    "dv": "42791545.505673",
                    "o": 305.1000000000000227373675443232059478759765625,
                    "h": 305.66000000000002501110429875552654266357421875,
                    "l": 300.56999999999999317878973670303821563720703125,
                    "c": 302.25,
                    "v": 42791545,
                    "vw": 302.29790000000002692104317247867584228515625
                },
                "lastQuote": {
                    "P": 302.23000000000001818989403545856475830078125,
                    "S": 40,
                    "p": 302.01999999999998181010596454143524169921875,
                    "s": 40,
                    "t": 1786569719220204206
                },
                "lastTrade": {
                    "c": [
                        12
                    ],
                    "i": "477415",
                    "p": 302.01999999999998181010596454143524169921875,
                    "s": 100,
                    "t": 1786569739534723728,
                    "x": 4,
                    "ds": "100.0"
                },
                "min": {
                    "dv": "12011.055938",
                    "dav": "42791545.505673",
                    "av": 42791545,
                    "t": 1786569660000,
                    "n": 100,
                    "o": 302.08999999999997498889570124447345733642578125,
                    "h": 302.220000000000027284841053187847137451171875,
                    "l": 302.08999999999997498889570124447345733642578125,
                    "c": 302.19999999999998863131622783839702606201171875,
                    "v": 12011,
                    "vw": 302.15870000000001027729013003408908843994140625
                },
                "prevDay": {
                    "o": 307.75,
                    "h": 309.970000000000027284841053187847137451171875,
                    "l": 302.79000000000002046363078989088535308837890625,
                    "c": 304.91000000000002501110429875552654266357421875,
                    "v": 37476746.31650499999523162841796875,
                    "vw": 305.66059999999998808561940677464008331298828125
                }
            },
            "status": "OK",
            "request_id": "89e72140dc69c4dccc8df5d60743e57d"
        }
    }
}

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