predict

A wallet's open Polymarket positions.

A wallet's open Polymarket positions. Pass the wallet (proxy) address; cap with limit. Each position returns the market title + outcome, share size, average vs current price, initial vs current USD value, unrealized USD P&L and percent P&L, whether it's redeemable, and the conditionId/slug. For inspecting any trader's live book (e.g. a wallet from predict.leaderboard or predict.whales). Read-only from Polymarket's Data API.

get/api/predict/positions

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/predict/positions
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

addressstring required

Wallet (proxy) address.

limitinteger

Max positions (default 50).

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.