GET
/v2/snapshot/locale/us/markets/stocks/tickers/{stocksTicker}
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., c2591ef64d951775783c7bbd7b9eb781) |
Example Response
{
"ok": true,
"data": {
"status": "OK",
"ticker": {
"ticker": "AAPL",
"todaysChangePerc": 0.77828120432621872293310616441885940730571746826171875,
"todaysChange": 2.1299999999999954525264911353588104248046875,
"updated": 1770848280000000000,
"day": {
"o": 274.69499999999999317878973670303821563720703125,
"h": 280.18000000000000682121026329696178436279296875,
"l": 274.44999999999998863131622783839702606201171875,
"c": 275.5,
"v": 51377095,
"vw": 276.88429999999999608917278237640857696533203125
},
"lastQuote": {
"P": 275.970000000000027284841053187847137451171875,
"S": 300,
"p": 275.759999999999990905052982270717620849609375,
"s": 100,
"t": 1770848344427990477
},
"lastTrade": {
"c": [
12
],
"i": "194540",
"p": 275.81000000000000227373675443232059478759765625,
"s": 100,
"t": 1770848243319968809,
"x": 12
},
"min": {
"av": 51377090,
"t": 1770848220000,
"n": 16,
"o": 275.81000000000000227373675443232059478759765625,
"h": 275.81000000000000227373675443232059478759765625,
"l": 275.81000000000000227373675443232059478759765625,
"c": 275.81000000000000227373675443232059478759765625,
"v": 213,
"vw": 271.39600000000001500666257925331592559814453125
},
"prevDay": {
"o": 274.884999999999990905052982270717620849609375,
"h": 275.3700000000000045474735088646411895751953125,
"l": 272.93999999999999772626324556767940521240234375,
"c": 273.68000000000000682121026329696178436279296875,
"v": 34382285,
"vw": 273.89280000000002246451913379132747650146484375
}
},
"results": {
"ticker": {
"ticker": "AAPL",
"todaysChangePerc": 0.77828120432621872293310616441885940730571746826171875,
"todaysChange": 2.1299999999999954525264911353588104248046875,
"updated": 1770848280000000000,
"day": {
"o": 274.69499999999999317878973670303821563720703125,
"h": 280.18000000000000682121026329696178436279296875,
"l": 274.44999999999998863131622783839702606201171875,
"c": 275.5,
"v": 51377095,
"vw": 276.88429999999999608917278237640857696533203125
},
"lastQuote": {
"P": 275.970000000000027284841053187847137451171875,
"S": 300,
"p": 275.759999999999990905052982270717620849609375,
"s": 100,
"t": 1770848344427990477
},
"lastTrade": {
"c": [
12
],
"i": "194540",
"p": 275.81000000000000227373675443232059478759765625,
"s": 100,
"t": 1770848243319968809,
"x": 12
},
"min": {
"av": 51377090,
"t": 1770848220000,
"n": 16,
"o": 275.81000000000000227373675443232059478759765625,
"h": 275.81000000000000227373675443232059478759765625,
"l": 275.81000000000000227373675443232059478759765625,
"c": 275.81000000000000227373675443232059478759765625,
"v": 213,
"vw": 271.39600000000001500666257925331592559814453125
},
"prevDay": {
"o": 274.884999999999990905052982270717620849609375,
"h": 275.3700000000000045474735088646411895751953125,
"l": 272.93999999999999772626324556767940521240234375,
"c": 273.68000000000000682121026329696178436279296875,
"v": 34382285,
"vw": 273.89280000000002246451913379132747650146484375
}
},
"status": "OK",
"request_id": "c2591ef64d951775783c7bbd7b9eb781"
}
}
}