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., 26162b26e4893adc718951fe05171a7d)

Example Response

{
    "ok": true,
    "data": {
        "status": "OK",
        "ticker": {
            "ticker": "AAPL",
            "todaysChangePerc": 0.195784866981454530598938390539842657744884490966796875,
            "todaysChange": 0.509999999999990905052982270717620849609375,
            "updated": 1775865600000000000,
            "day": {
                "dv": "31282305.359425",
                "o": 259.98000000000001818989403545856475830078125,
                "h": 262.18999999999999772626324556767940521240234375,
                "l": 259.02312299999999822830432094633579254150390625,
                "c": 260.48000000000001818989403545856475830078125,
                "v": 31282305,
                "vw": 260.41699999999997316990629769861698150634765625
            },
            "lastQuote": {
                "P": 261,
                "S": 800,
                "p": 260.69999999999998863131622783839702606201171875,
                "s": 500,
                "t": 1775865572628920800
            },
            "lastTrade": {
                "c": [
                    12,
                    41
                ],
                "i": "16999",
                "p": 261,
                "s": 142,
                "t": 1775865586754790495,
                "x": 8,
                "ds": "142.0"
            },
            "min": {
                "dv": "527.0",
                "dav": "31282305.359425",
                "av": 31282305,
                "t": 1775865540000,
                "n": 22,
                "o": 261,
                "h": 261,
                "l": 261,
                "c": 261,
                "v": 527,
                "vw": 260.98849999999998772182152606546878814697265625
            },
            "prevDay": {
                "o": 259,
                "h": 261.1200000000000045474735088646411895751953125,
                "l": 256.06999999999999317878973670303821563720703125,
                "c": 260.490000000000009094947017729282379150390625,
                "v": 28116607.0583789981901645660400390625,
                "vw": 259.39019999999999299689079634845256805419921875
            }
        },
        "results": {
            "ticker": {
                "ticker": "AAPL",
                "todaysChangePerc": 0.195784866981454530598938390539842657744884490966796875,
                "todaysChange": 0.509999999999990905052982270717620849609375,
                "updated": 1775865600000000000,
                "day": {
                    "dv": "31282305.359425",
                    "o": 259.98000000000001818989403545856475830078125,
                    "h": 262.18999999999999772626324556767940521240234375,
                    "l": 259.02312299999999822830432094633579254150390625,
                    "c": 260.48000000000001818989403545856475830078125,
                    "v": 31282305,
                    "vw": 260.41699999999997316990629769861698150634765625
                },
                "lastQuote": {
                    "P": 261,
                    "S": 800,
                    "p": 260.69999999999998863131622783839702606201171875,
                    "s": 500,
                    "t": 1775865572628920800
                },
                "lastTrade": {
                    "c": [
                        12,
                        41
                    ],
                    "i": "16999",
                    "p": 261,
                    "s": 142,
                    "t": 1775865586754790495,
                    "x": 8,
                    "ds": "142.0"
                },
                "min": {
                    "dv": "527.0",
                    "dav": "31282305.359425",
                    "av": 31282305,
                    "t": 1775865540000,
                    "n": 22,
                    "o": 261,
                    "h": 261,
                    "l": 261,
                    "c": 261,
                    "v": 527,
                    "vw": 260.98849999999998772182152606546878814697265625
                },
                "prevDay": {
                    "o": 259,
                    "h": 261.1200000000000045474735088646411895751953125,
                    "l": 256.06999999999999317878973670303821563720703125,
                    "c": 260.490000000000009094947017729282379150390625,
                    "v": 28116607.0583789981901645660400390625,
                    "vw": 259.39019999999999299689079634845256805419921875
                }
            },
            "status": "OK",
            "request_id": "26162b26e4893adc718951fe05171a7d"
        }
    }
}

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