Polyrankdocs

Changelog

API and product changes that affect integrations.

2026-06-11

Webhooks: production events are live. market.resolved and signal.smart_money now fire for real — market.resolved within ~2 minutes of the on-chain resolution, signal.smart_money in real time when a smart-money-tagged wallet takes a $5,000+ fill. Per-subscription filter_json filters (condition, trader, signal type, tags, min size) are honored at emission. See Webhooks for payloads. trader.fill remains deferred (use the realtime WebSocket for per-fill streaming). The agent-tier GET /v1/agent/signals/smart-money feed is populated by the same pipeline.

Four new agent endpoints. The routes announced as "coming soon" are now live and priced in /x402/info:

  • GET /v1/agent/trader/{proxy}/playbook — $0.01
  • GET /v1/agent/market/{conditionId}/flow — $0.005
  • POST /v1/agent/rankings/custom — $0.05 (the composite ranking engine, same config shape as the in-app Ranking Builder)
  • GET /v1/agent/rankings/preset/{slug} — $0.01

Trader addresses are now normalized to EIP-55 checksum on every agent route — lowercase addresses no longer return not_found.

2026-06-10

x402 wire format is now spec-official. The agent tier speaks the official x402 V1 wire format end-to-end:

  • 402 bodies are {x402Version: 1, error, accepts} with wire network names (base) and the extra EIP-712 domain — official SDKs (@x402/fetch, x402-axios, Python x402) now work out of the box.
  • X-PAYMENT accepts the official payload; the legacy flat Polyrank encoding ({scheme, network: "base-mainnet", signature, authorization}) still works during a deprecation window. Migrate now — the legacy encoding and the x402: "0.1" body aliases will be removed.
  • Settlement now happens before the response and returns the X-PAYMENT-RESPONSE receipt header with the on-chain tx hash. Failed settlement returns 402 and never charges you.

Pricing table cleanup. Four announced-but-unimplemented agent routes (trader playbook, market flow, custom rankings, preset rankings) are removed from /x402/info and the 402 pricing until their handlers ship.

docs.polyrank.app launched — this site: x402 guide, full generated API reference, MCP, WSS, webhooks, billing.

2026-06-09

  • Public API launched: anonymous /v1/public/* namespace (leaderboard, trader, calibration, market, pulse, founding) + llms.txt.
  • x402 agent tier live on Base mainnet (5 endpoints).
  • MCP server @polyrank/mcp built — see MCP. Now published to the public npm registry (npx -y @polyrank/mcp works; latest 0.2.0).
  • Founding Trader offer: Pro at $23/mo for the first 250 seats.

On this page