API & INTEGRATION

API Reference

Auth & Rate Limits

  • API Key via dashboard (per tier). Include Authorization: Bearer <key>.
  • Rate limits scale by tier; 429 returned on excess.

REST Endpoints

1
2GET /v1/commits?pair=BTCUSDT&tf=5m&since=...
3
4GET /v1/reveals?pair=BTCUSDT&tf=5m&since=...
5
6GET /v1/signals?verified=true&limit=100
7
8GET /v1/signal/:id  # returns payload, nonce (post-reveal), proofs
9
10POST /v1/webhooks/test  # ping your webhook
11

Signal Schema

1{
2  "id": "sig_01H...",
3  "commit": {
4    "tx": "0x...", "block": 123, "hash": "0xleafOrHash", "root": "0x...|null",
5    "meta": { "pairId": 1, "tfId": 1, "modelId": 12, "publisher": "0x..."}
6  },
7  "reveal": {
8    "ts": "2025-08-15T18:27:44Z",
9    "payload": {/* payload without nonce */},
10    "nonce": "0x...",
11    "proof": ["0x..."]
12  },
13  "verified": true
14}

Webhooks

  • Register a webhook URL in dashboard.
  • We POST JSON on new commit, reveal, status changes.

OpenAPI Spec (Excerpt)

1
2openapi: 3.0.3
3info: { title: Chain Tick API, version: 1.0.0 }
4paths:
5/v1/signals:
6  get:
7    summary: List signals
8    parameters:
9    - { name: verified, in: query, schema: { type: boolean } }
10    - { name: pair, in: query, schema: { type: string } }
11    - { name: tf, in: query, schema: { type: string, enum: [5m,15m,1h] } }
12    responses: { '200': { description: OK } }
13