Developer API

TradeSys API v1

Programmatic access to every trade, every exchange, every token. Server-side, perpetual, tick-level. REST over HTTPS. Bearer-token auth. Edge-cached responses.

Authentication

Every request to /api/v1/* must carry a Bearer key. Create one at /settings/api-keys.

curl -H "Authorization: Bearer ts_live_..." \
  https://tradesys.io/api/v1/tokens

Keys are returned in full exactly once. Store them securely — we only retain a sha256 hash, so a lost key cannot be recovered.

Pricing & limits

Tier	Req / min	Monthly quota	Price
Free	60	1,000	$0
Pro	300	100,000	$29 / mo
Enterprise	1,200	2,000,000	contact sales

Every response carries X-RateLimit-Remaining-Minute and X-RateLimit-Remaining-Month headers. 429 on per-minute breach, 402 on quota exhaustion.

Endpoints

GET/api/v1/tokens

List every trade-analysis token TradeSys tracks. Metadata only — use the per-token endpoints for market data.

curl -H "Authorization: Bearer $KEY" \
  https://tradesys.io/api/v1/tokens
# { "tokens": [{ "id": "helium", "symbol": "HNT", "name": "Helium", ... }], "count": 23 }

GET/api/v1/tokens/{id}/markets

Cross-venue liquidity snapshot. 24h volume, VWAP, cross-venue median price, three synthetic slippage bands per venue.

curl -H "Authorization: Bearer $KEY" \
  https://tradesys.io/api/v1/tokens/helium/markets
# { "token_id": "helium", "markets": [
#     { "exchange": "binance", "volume_24h": 12340000,
#       "price_last": 2.41, "slippage_10k_bps": 2.3, ... },
#     ...
#   ], "count": 37 }

GET/api/v1/tokens/{id}/trades

Paginated recent trades across every venue for a token. Use ?since=<cursor> to paginate forward.

Query params

since: (number) Epoch ms — return trades newer than this timestamp. Use the cursor from the previous page.
limit: (number) Max 1000. Default 100.
exchange: (string) Optional venue filter (binance, uniswap, etc.).

curl -H "Authorization: Bearer $KEY" \
  "https://tradesys.io/api/v1/tokens/helium/trades?limit=100"
# { "token_id": "helium",
#   "trades": [
#     { "id": "binance-HNTUSDT-123", "ts": 1776580487000,
#       "price": 2.41, "size": 23.5, "side": "buy",
#       "exchange": "binance", "pair": "HNTUSDT" },
#     ...
#   ],
#   "cursor": 1776580487000, "count": 100 }

Public / unauthenticated

Some endpoints don't require a key — they power the website itself and are cached aggressively at the edge. Feel free to embed.

GET /api/public/screener — one-row-per-token universe snapshot
GET /api/public/big-swaps?minutes=15 — largest cross-venue trades in the window
GET /api/public/signal-score/{id} — composite 0-99 heat score
GET /api/public/trust-scores — per-venue trust snapshot
GET /feed/token/{id}/signals.xml — per-token signal fires (Atom)

Versioning

The v1 contract above is stable. Breaking changes ship under /api/v2 with a deprecation window of at least 90 days. Additive fields on existing responses are not considered breaking — always ignore unknown keys on the client.

Status

Live health at /exchanges (per-venue trust score, uptime, latency) and system error rate at /admin (admin-only).