AWS-backed Polymarket data infrastructure

Polyfeed

A sellable external API and internal terminal data plane for Polymarket trades, settlements, wallet positions, candles, indexed history, and live WebSocket streams.

View API SurfaceRead Docs
polyfeed.liveready
status
chain
polygon / 137
decoder
polyfeed-decoder-v1
finality
64 blocks
fanout
websocket mvp
latest event
{
  "type": "trade",
  "exchange_version": "ctf_exchange_v2",
  "observed_at": "2026-05-01T16:58:29Z",
  "decoded_at": "2026-05-01T16:58:29Z",
  "confirmed_at": "2026-05-01T16:58:28Z"
}
indexed primitives
trades
settlements
wallet positions
polyfeed

Product API, not an internal script.

Polyfeed ships as an external customer surface from day one: API keys, scopes, request logs, rate limits, usage metering, status endpoints, and SDK support.

GET /healthGET /readyGET /statusGET /v1/markets/searchGET /v1/tradesGET /v1/wallets/:wallet/tradesGET /v1/wallets/:wallet/positionsGET /v1/markets/:marketId/candlesPOST /v1/rpc
polyfeed

WebSocket streams built for trading terminals.

Subscribers can listen by event type and filter by wallet, market, token, side, size, and exchange version. Pending V2 matchOrders calldata emits pending settlement lifecycle events; confirmed fills emit status updates.

Confirmed trade and settlement decoding

Indexes Polygon receipts and decodes Polymarket-relevant event logs with idempotent database writes.

WebSocket stream for terminals

Subscribes customers to trade, settlement, wallet, market, status, and block event channels.

Sellable external API foundation

API keys, scopes, rate-limit hooks, request logs, usage metering, and plan fields are first-class surfaces.

AWS-native deployment shape

Designed for ECS/Fargate, RDS Postgres, ElastiCache Redis, private Polygon nodes, ALB/WAF, and OpenTelemetry.

subscribe message
{
  "action": "subscribe",
  "type": "settlement",
  "filters": {
    "wallets": ["0x..."],
    "condition_ids": ["0x..."],
    "exchange_version": "ctf_exchange_v2"
  }
}
delivery contract

MVP fanout persists stream events and uses Redis pub/sub when configured. Pending settlement coverage depends on authorized Polygon pending-transaction sources; private mempool feeds are a later production stage.

polyfeed

Own the Polygon and contract decoding path.

The service is designed around public on-chain data, verified ABIs, event signatures, calldata decoding, receipt fixtures, and lawful bytecode analysis when source is unavailable.

Indexer

Backfill and live-follow modes with finality-aware cursors.

Decoder registry

Conditional Tokens, CTF Exchange V1/V2, NegRisk, collateral, and token movement paths.

RPC proxy

Fast local block/gas paths with managed upstream fallback.

AWS runtime

ECS/Fargate, RDS Postgres, ElastiCache Redis, private nodes, ALB/WAF, CloudWatch.

indexer lag
node health
stream throughput
queue depth
connected clients
decoder version
reorg stats
dropped events
TradeBetter terminal operations room

terminal-ready

Switch providers without breaking the product.

polyfeed

One env flag moves the terminal onto internal data.

Existing PolyNode behavior remains the default. The terminal can opt into Polyfeed using the same provider abstraction that already powers wallet analytics, enrichment, candles, and activity.

terminal env
POLYMARKET_DATA_PROVIDER=internal
POLYMARKET_DATA_BASE_URL=https://api.tradebetter.app/polyfeed
POLYMARKET_DATA_WS_URL=wss://api.tradebetter.app/polyfeed/ws
POLYMARKET_DATA_API_KEY=polyfeed_live_...

external API beta

Build on the same Polymarket data plane as the terminal.

Open DocsLaunch Terminal