API reference · Polymarket
polymarket/market-positions
Integrate this model through SandBase's unified API, with production-ready schemas and examples.
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/api/polymarket/market-positionsModel ID
polymarket/market-positions01
Input Schema
7 parameters · 1 required · 6 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
market | string | Required | The condition ID of the market to query positions for |
user | string | Optional | Filter to a single user by proxy wallet address |
limit | integer | Optional | Max number of positions to return per outcome token · Min: 0 · Max: 500 · Default: 50 |
offset | integer | Optional | Pagination offset per outcome token · Min: 0 · Max: 10000 · Default: 0 |
sortBy | string | Optional | Sort positions by: - `TOKENS` — Position size (number of tokens) - `CASH_PNL` — Unrealized cash PnL - `REALIZED_PNL` — Realized PnL - `TOTAL_PNL` — Total PnL (cash_pnl + realized_pnl) · Options: TOKENS, CASH_PNL, REALIZED_PNL, TOTAL_PNL · Default: "TOTAL_PNL" TOKENSCASH_PNLREALIZED_PNLTOTAL_PNL |
status | string | Optional | Filter positions by status. - `OPEN` — Only positions with size > 0.01 - `CLOSED` — Only positions with size <= 0.01 - `ALL` — All positions regardless of size · Options: OPEN, CLOSED, ALL · Default: "ALL" OPENCLOSEDALL |
sortDirection | string | Optional | sortDirection · Options: ASC, DESC · Default: "DESC" ASCDESC |
02
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
03
Code Examples
Ready-to-run snippets
const apiKey = process.env.SANDBASE_API_KEY;
const response = await fetch("https://api.sandbase.ai/v1/api/polymarket/market-positions", {
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"user": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
"limit": 50,
"market": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
"offset": 0,
"sortBy": "TOTAL_PNL",
"status": "ALL",
"sortDirection": "DESC"
}),
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());