Historical auctions
GET {{baseUrl}}/v2/stocks/auctions?symbols=AAPL,TSLA
The historical auctions endpoint provides auction prices for the stock symbol between the specified dates.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
start | string | The inclusive start of the interval. Format: RFC-3339 or YYYY-MM-DD. | |
| If missing, the default value is the beginning of the current day. | |||
end | string | The inclusive end of the interval. Format: RFC-3339 or YYYY-MM-DD. | |
| If missing, the default value is the current time. | |||
asof | string | The asof date of the queried stock symbol(s) in YYYY-MM-DD format. Default is the current day. |
This date is used to identify the underlying entity of the provided symbol(s) so that name changes for this entity can be found. Data for past symbol(s) is returned if the query date range spans the name change.
The special value of "-" means symbol mapping is skipped. Data is returned based on the symbol alone without looking up previous names. The same happens if the queried symbol is not found on the given asof date.
Example: FB was renamed to META in 2022-06-09. Querying META with an asof date after
2022-06-09 will also yield FB data. The data for the FB ticker will be labeled as META
because they are considered the same underlying entity as of 2022-06-09.
Querying FB with an asof date after 2022-06-09 will only return data with the FB ticker,
not with META. But with an asof date before 2022-06-09, META will also be returned (as FB).
|
| currency | string | | The currency of all prices in ISO 4217 format. Default is USD.
|
| page_token | string | | Pagination token to continue from. The value to pass here is returned in specific requests when more data is available than the request limit allows. |
| symbols | string | | |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"auctions":{"AAPL":[{"c":[{"c":"M","p":182,"s":100,"t":"2022-01-03T21:00:00.121043712Z","x":"P"},{"c":"6","p":182.01,"s":6948189,"t":"2022-01-03T21:00:00.287Z","x":"T"},{"c":"6","p":182.01,"s":6948189,"t":"2022-01-03T21:00:00.287713497Z","x":"Q"},{"c":"M","p":182.01,"s":6948189,"t":"2022-01-03T21:00:00.287781252Z","x":"Q"}],"d":"2022-01-03","o":[{"c":"Q","p":177.89,"s":1,"t":"2022-01-03T14:30:00.133104896Z","x":"P"},{"c":"O","p":177.81,"s":817599,"t":"2022-01-03T14:30:02.332Z","x":"T"},{"c":"O","p":177.81,"s":817599,"t":"2022-01-03T14:30:02.33248559Z","x":"Q"},{"c":"Q","p":177.81,"s":817599,"t":"2022-01-03T14:30:02.332973413Z","x":"Q"}]},{"c":[{"c":"M","p":179.69,"s":100,"t":"2022-01-04T21:00:00.120105728Z","x":"P"},{"c":"6","p":179.7,"s":5972464,"t":"2022-01-04T21:00:00.381Z","x":"T"},{"c":"6","p":179.7,"s":5972464,"t":"2022-01-04T21:00:00.381672826Z","x":"Q"},{"c":"M","p":179.7,"s":5972464,"t":"2022-01-04T21:00:00.381690974Z","x":"Q"}],"d":"2022-01-04","o":[{"c":"Q","p":182.62,"s":5,"t":"2022-01-04T14:30:00.133106688Z","x":"P"},{"c":"O","p":182.61,"s":807199,"t":"2022-01-04T14:30:00.403781506Z","x":"Q"},{"c":"O","p":182.61,"s":807199,"t":"2022-01-04T14:30:00.416Z","x":"T"},{"c":"Q","p":182.61,"s":807199,"t":"2022-01-04T14:30:00.416891929Z","x":"Q"}]}]},"next_page_token":null}