API Reference
The Draft v0.1 Time Seventeen REST and WebSocket protocol, organized by endpoint family.
Draft v0.1 — design contract, not yet a live service
This documentation set defines a proposed Time Seventeen protocol for review and implementation planning. https://api.t17.capital is the approved and reserved REST origin, but neither that origin nor any documented endpoint is claimed to be live. The WebSocket origin remains unspecified. Credentials, chain IDs, contract addresses, rate limits, and SLAs remain unapproved; IDs, prices, and timestamps shown throughout are illustrative, not real production data.
This reference defines the complete Draft v0.1 contract: request/response shapes, enums, headers, and error codes. It does not describe a deployed service — no backend, matching engine, index calculator, rating engine, or SDK exists yet. Treat every route, ID, and value as a design proposal pending implementation and security review.
Start here
- Conventions — versioning, media type, identifiers, fixed-point decimals, timestamps, envelopes, pagination, and reliability rules shared by every endpoint.
- Authentication — public vs. private access, API keys, canonical request signing, and EIP-712 account/order authorization.
- Endpoints — the complete method/path/auth catalog, cross-linked to every detailed page below.
- Errors — the structured error envelope and stable code families.
Public market data and assessments
Indexes
List/detail/version/constituent and methodology endpoints.
Markets
Events, markets, outcomes, and venue mappings.
Prices
Current and historical index/market prices, candles, order books, and trades.
Ratings
Independent Market Rating (MR1-MR5/NR) current, history, and methodology.
Severity
Independent Severity Assessment (SEV-0-SEV-5/UNKNOWN) current, history, and methodology.
Private trading and account data
Orders
Create, list, batch, amend, cancel, and cancel-all.
Fills
Immutable executions, fees, and maker/taker attribution.
Positions
Settled/unsettled positions and account balances.
Settlement
Matching-vs-settlement boundary and redemption state.
WebSocket
Public and private real-time streams.
Reading order by role
| You are | Read |
|---|---|
| A market-data integrator | Conventions → Indexes → Markets → Prices |
| A rating/severity consumer | Conventions → Ratings → Severity |
| A trader | Conventions → Authentication → Orders → Fills → Positions → Settlement → WebSocket |
Continue to Conventions.