Pulse Markets
Pulse Markets docsList corporate actions
Corporate actions for an instrument, filtered by effective date. Each action carries effectiveDate (when it happened), knowledgeDate (when it became knowable) and knowledgeProvenance (how that instant was established). asOf filters on knowledgeDate, so an action that only became knowable after your cut-off is absent. knowledgeDate is deliberately not createdAt: for an announced dividend it is the end of the declaration day, and for a backfilled action it is null, meaning we cannot honestly date it - such actions are excluded from every asOf read unless you set includeBackfilled.
Corporate actions for an instrument, filtered by effective date. Each action carries effectiveDate (when it happened), knowledgeDate (when it became knowable) and knowledgeProvenance (how that instant was established). asOf filters on knowledgeDate, so an action that only became knowable after your cut-off is absent. knowledgeDate is deliberately not createdAt: for an announced dividend it is the end of the declaration day, and for a backfilled action it is null, meaning we cannot honestly date it - such actions are excluded from every asOf read unless you set includeBackfilled.
Authorization
ApiKeyAuth actions:readPresent your API key as a bearer token: Authorization: Bearer pk_live_....
Two environments are issued per account. A pk_test_ sandbox key returns the SAME real historical data as a live key and does NOT consume your LIVE allowance, so learning the API is free. It has its own separate windows and can be rate limited on them. A pk_live_ key reads against your allowance.
Keys carry explicit scopes (instruments:read, prices:read, actions:read, fx:read, earnings:read, options:read, news:read, sentiment:read, events:read, analytics:read, correlations:read, technicals:read, macro:read) and are enforced fail-closed, so a leaked key is bounded to what it was issued for. Revocation is immediate.
In: header
Scope: actions:read
Path Parameters
Instrument identifier (UUID).
uuidQuery Parameters
Earliest effective date, inclusive.
^\d{4}-\d{2}-\d{2}$Latest effective date, inclusive.
^\d{4}-\d{2}-\d{2}$Point-in-time knowledge cut-off. Returns the answer as it would have been known at this moment, excluding any corporate action that only became knowable afterwards. A date is treated as the end of that day; a full ISO instant is used exactly.
^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d{1,3})?Z)?$Include corporate actions whose knowledge date is unknown (provenance = backfilled). Off by default, because such an action cannot honestly be presented as something a reader knew on your asOf date. Setting it true forces meta.provenance.pitValid to false whenever such an action actually contributed.
"false"Value in
- "true"
- "false"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/instruments/497f6eca-6276-4993-bfeb-53cbbbba6f08/corporate-actions?from=string&to=string"{ "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "instrumentId": "48367a03-b541-4ea7-88a6-ae604df75c64", "kind": "split", "effectiveDate": "string", "createdAt": "string", "knowledgeProvenance": "observed", "announcementDate": "string", "knowledgeDate": "string", "params": { "property1": null, "property2": null }, "source": "string" } ], "meta": { "asOf": "string", "source": "string", "stale": true, "provenance": { "observed": -9007199254740991, "vendor_pit": -9007199254740991, "announced": -9007199254740991, "backfilled": -9007199254740991, "pitValid": true } }}{ "error": { "code": "invalid_request", "message": "string", "docsUrl": "http://example.com", "details": { "property1": [ "string" ], "property2": [ "string" ] } }}{ "error": { "code": "invalid_request", "message": "string", "docsUrl": "http://example.com", "details": { "property1": [ "string" ], "property2": [ "string" ] } }}{ "error": { "code": "invalid_request", "message": "string", "docsUrl": "http://example.com", "details": { "property1": [ "string" ], "property2": [ "string" ] } }}{ "error": { "code": "invalid_request", "message": "string", "docsUrl": "http://example.com", "details": { "property1": [ "string" ], "property2": [ "string" ] } }}{ "error": { "code": "invalid_request", "message": "string", "docsUrl": "http://example.com", "details": { "property1": [ "string" ], "property2": [ "string" ] } }}{ "error": { "code": "invalid_request", "message": "string", "docsUrl": "http://example.com", "details": { "property1": [ "string" ], "property2": [ "string" ] } }}Get beta against a benchmark GET
The beta, alpha and R-squared of an instrument's log returns regressed on a benchmark's, over a lookback. Both series are aligned on their common dates first, so the regression uses only the days both traded. When the aligned data is insufficient (fewer than three overlapping observations) or degenerate (a benchmark with zero return variance), beta, alpha and rSquared are ALL null and observations names the honest reason - never a fabricated beta of 1. Returns 404 for an unknown subject instrument.
List earnings events GET
Scheduled and historical earnings reports for an instrument.