GET /v1/calendar/series/{id}/history
#GET /v1/calendar/series/{id}/historylistCalendarSeriesHistory
A series' released figures, newest first
| Scope | calendar:read |
|---|---|
| Lowest tier | sandbox |
| Weight (units) | 5 |
| History each tier may read | Sandbox: 92 days; Starter: 366 days; Elite (included): 366 days; Developer: 800 days; Business: 800 days |
| Paginated | yes: follow meta.next_cursor |
| SDK | Python client.calendar.series_history ยท JavaScript cd.calendar.seriesHistory |
Parameters
| Parameter | In | Type | Description |
|---|---|---|---|
id required | path | string | Series id (e.g. US.CPI.MOM). |
from | query | string | Start, inclusive: unix seconds or RFC 3339. |
to | query | string | End, exclusive: unix seconds or RFC 3339. Default now. |
limit | query | integer | Rows per page, at most 500 (default 100). |
cursor | query | string | meta.next_cursor of the previous page (opaque; bound to the route). |
Errors
400invalid_param, invalid_cursor401unauthorized: missing, unknown, revoked or expired key403insufficient_scope, tier_required404not_found, not_available, not_in_sandbox422window_too_large429rate_limited (per minute) or quota_exhausted (month; X-Quota-* headers, Retry-After = seconds to the next month); see Retry-After503api_disabled, overloaded
Example
curl "https://api.chartdeck.trade/v1/calendar/series/<id>/history" \
-H "Authorization: Bearer $CHARTDECK_API_KEY"from chartdeck import Client
client = Client() # reads CHARTDECK_API_KEY
r = client.calendar.series_history("<id>")
print(r.data, r.meta["attribution"])import { ChartDeck } from '@chartdeck/api';
const cd = new ChartDeck(); // reads CHARTDECK_API_KEY
const r = await cd.calendar.seriesHistory("<id>");
console.log(r.data, r.meta.attribution);