API reference

Base URL https://www.tokirwa.com/v1
Live now · seeded demo data · reads need no key

Public endpoints

Every response carries observed_at. Missing information is returned as unknown, never fabricated. The demo running on this origin serves deterministic seeded data, transparently labeled via source.type = "seeded_demo" where applicable.

Query parameters

?asset=AAPL
?event_type=dividend.ex_date      # or a family prefix: dividend
?status=confirmed
?severity=notable
?from=2026-07-17T00:00:00Z
?to=2026-07-24T00:00:00Z
?limit=200                        # max 500
?include=clock                    # /v1/assets only

Webhook delivery

Authenticated endpoints (POST /v1/webhooks and friends) are live — manage them in the webhook console. Every delivery is signed and replayable:

Toki-Event-Id: evt_01K0…
Toki-Timestamp: 1784289962
Toki-Signature: v1=hmac_sha256(secret, timestamp + "." + body)

Guarantees: at-least-once delivery · stable event IDs for deduplication · exponential retry · seven-day delivery history.

Error shape

{
  "error": {
    "code": "ASSET_NOT_FOUND",
    "message": "No covered asset matches this identifier.",
    "request_id": "req_01K0…"
  }
}

Rate limits

Plan	Requests / month	Webhooks	Delivery logs
Free	500	1 endpoint	—
Developer $29	50,000	5 endpoints	7 days
Pro $99	500,000	Higher limits	7 days + export
Protocol	Custom	Dedicated channel	SLA

API keys

Provision a demo key instantly in the webhook console. The public read endpoints on this origin need no key; webhook management is key-scoped.

Open the console