Polysink API

Getting started

Polysink gives you the entire Polymarket dataset — markets, events, on-chain and CLOB trades, orderbooks, wallets, leaderboards, and microstructure analytics — through one REST + WebSocket API. Base URLs:

REST       https://api.polysink.io
WebSocket  wss://api.polysink.io

Every request is authenticated with an API key. Sign up, pick a plan, and create a key in the dashboard — then your first request is one curl away:

curl -s "https://api.polysink.io/v1/markets?status=active&limit=5" \
  -H "Authorization: Bearer $POLYSINK_KEY"

If you work in TypeScript, the official SDK wraps every endpoint and stream with full types — see the SDK section below.

Authentication

All /v1 REST routes require an Authorization header with your API key. Only the health probes (GET /health and GET /health/matcher) are public.

curl -s "https://api.polysink.io/v1/markets" \
  -H "Authorization: Bearer $POLYSINK_KEY"

WebSocket connections accept the same Authorization header, or — for browser clients that can't set headers — the token can ride in the WebSocket subprotocol. The server echoes the bearer subprotocol back on a successful upgrade and pings every 30 seconds to keep the connection alive.

const ws = new WebSocket(
  "wss://api.polysink.io/v1/ws/trades",
  ["bearer", POLYSINK_KEY],
);

Errors & conventions

Errors are returned as a JSON object with a single error message. Status codes follow the usual conventions:

{ "error": "message" }

400 — invalid query or body values · 401 — missing or invalid token · 404 — unknown market, event, or wallet · 503 — the market matcher is still warming up · 500 — backend failure.

List endpoints share two pagination parameters: limit and offset. Timestamps are RFC3339 unless an endpoint says otherwise; prices are decimal strings to preserve precision — never floats.

Markets

Market matching

The matcher turns free text — a tweet, a headline, a search query — into ranked Polymarket markets. It runs against a prewarmed snapshot of the catalog, so responses are fast and deterministic.

{
  "matches": [
    {
      "market_id": "512329",
      "condition_id": "0x1a9e…",
      "url": "https://polymarket.com/event/…",
      "title": "Fed cuts rates in March?",
      "relevance_score": 0.93,
      "deterministic_score": 0.88,
      "causation_label": "direct"
    }
  ]
}

Orderbook history

Events & tags

Trades

Polysink normalizes on-chain exchange fills and off-chain CLOB executions into one trade shape, so a wallet's history and a market's tape read the same way regardless of where the fill happened.

Wallets

Leaderboard & categories

Analytics

Research-grade microstructure metrics computed continuously over the raw flow. All three endpoints share from/to time filters and pagination.

WebSockets

Three streams cover live data. Authenticate as described above; the server pings every 30 seconds, and messages are JSON.

{ "subscribe": ["0x1a9e…", "*"] }
{ "unsubscribe": ["0x1a9e…"] }

TypeScript SDK

@tenz-app/polysink-sdk wraps every REST endpoint and WebSocket stream with types generated directly from the API's Rust models. It's distributed through GitHub Packages — add the registry once, then install.

# .npmrc
@tenz-app:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}

pnpm add @tenz-app/polysink-sdk

import { Polysink } from "@tenz-app/polysink-sdk";

const client = new Polysink({ apiKey: process.env.POLYSINK_KEY });

const markets = await client.markets.list({ category: "sports", limit: 50 });
const candles = await client.markets.candles(markets[0].condition_id, {
  interval: "1h",
});
const leaders = await client.leaderboard.list({ limit: 100 });

import { MarketStream, AllTradesStream } from "@tenz-app/polysink-sdk";

const stream = new MarketStream({ apiKey: process.env.POLYSINK_KEY });
stream.subscribe("0x1a9e…", (u) => quote(u.best_bid, u.best_ask));

const firehose = new AllTradesStream({ apiKey: process.env.POLYSINK_KEY });
firehose.on("trade", (t) => tape(t.condition_id, t.price, t.size));

import { impliedProbability, formatUsd, vwap } from "@tenz-app/polysink-sdk/utils";
import type { MarketSummary, Candle } from "@tenz-app/polysink-sdk/types";

impliedProbability(0.75); // 75
formatUsd("1234567.89");  // "$1,234,567.89"

Health