Assets

Get Asset History

Daily total returns, spliced with your backfill rule when one exists, then cut to start_date/end_date so a dated read matches what a backtest sees. A read past the stored edge refreshes the bars first and waits a few seconds for them. Answers 202 with status: fetching while a load is still in flight and the window has nothing to show. data_edge is the last bar stored whatever the window, so an empty window is legible: past the edge, or before the listing.

get/v1/assets/{asset}/history

Request

  • Base URL: https://api.ensemble.markets (the document declares no server; this is the origin it was published from)
  • URL: https://api.ensemble.markets/v1/assets/{asset}/history
  • Auth: HTTP bearer

Path parameters

assetstring required

Symbol (AAPL) or asset ID (asset_... or legacy a-...)

Query parameters

includestring[] nullable

metrics: return, risk and drawdown statistics over the returned slice

backfillboolean

Splice your backfill rule in before the asset's first bar. False returns its own bars only.

start_datestring date nullable

Earliest bar to return (YYYY-MM-DD, inclusive). Omit for the beginning of the series (for a model, its default view start).

end_datestring date nullable

Latest bar to return (YYYY-MM-DD, inclusive). Omit for the end of the series.

Response

Successful Response

idstring required
symbolstring required
statusstring required
datesstring[]
returnsnumber[]
first_datestring date nullable
last_datestring date nullable
rowsinteger
start_datestring date nullable

Requested window start (inclusive)

end_datestring date nullable

Requested window end (inclusive)

fetched_atstring date-time nullable
data_edgestring date nullable

Last bar stored for the asset, whatever the window. An empty window that starts after this is past the edge, not missing data.

staleboolean

The bars are older than the refresh window; a refresh failed or is in flight

refreshingboolean

A refresh is running now; read again in a few seconds for the new edge

errorstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.