View Polymarket position records | BlockRun

View one page of Polymarket positions with each item's market and choice, shares, cost amounts shown, current value and profit or loss. No details are needed.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use polymarket-positions-blockrun to retrieve one default page of position records. Reuse my Toolmu connection, or follow https://toolmu.com/SKILL.md. Read get_tool for this exact name and check current availability, input contract, maximum credits, balance, budget and my existing spending authorization. The default list needs no wallet or market ID; submit {} for one page. If I choose documented optional query settings, put their names directly in queryParams, not queryParams.query. Optional min_timestamp and max_timestamp use integer Unix seconds, not milliseconds.

Show each returned wallet and market outcome with held shares, cost basis, lifetime purchase spending, current valuation and realized/unrealized P&L. Keep USD amounts separate from shares and the already expressed unrealized percentage; do not multiply it by 100 or invent its formula. Include zero-share records and keep outcome status separate from net profit or loss. Preserve missing, null and zero values. Confirm the output timestamp unit before date conversion, distinguish update blocks from dates, and report this page’s count and more-data flag. Get further pages only if I request them within my budget; do not infer complete portfolios or guaranteed fill prices.

Task:
Show one page of Polymarket positions. Explain each item's market and choice, shares, listed costs, current value and profit or loss. Include entries with no shares.

Paste into your connected AI's conversation.

Connection guide

Up to 0.01122 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

BlockRun

View Polymarket position records | BlockRun

View one page of Polymarket positions with each item's market and choice, shares, cost amounts shown, current value and profit or loss. No details are needed.

You receive

Get one page of available Polymarket position records across wallets. Each record connects a wallet and market outcome with held shares, average entry price, cost basis, lifetime purchase spending and current valuation. Realized and unrealized profit or loss are supplied separately. Compare the returned positions using shares for quantity and USD for the reported costs, value and monetary profit or loss. Read the unrealized percentage as supplied. Last-update metadata, the page count and a more-data indicator provide context for the records you receive.

Start with your task

Show one page of Polymarket positions. Explain each item's market and choice, shares, listed costs, current value and profit or loss. Include entries with no shares.

What to know

A page can include several wallets and closed positions with zero shares; it is a partial collection rather than a complete wallet portfolio. A market outcome marked as a win or loss does not determine the sign of net trading profit or loss. Source freshness and coverage are not guaranteed, and a reported price does not guarantee a fill. The percentage calculation is unspecified. An empty page means no records were returned for that request.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Optional list query settings`queryParams`	`object`	Optional	Leave out for a default page. If choosing documented source settings, put their names directly here: wallet, token_id, condition_id, order_by, order, block or timestamp bounds, limit or pagination_key. Timestamp bounds use inclusive Unix seconds. Source defaults are block, desc and limit100.
Optional nested query container`queryParams.query`	`object`	Optional	This native open object is optional and is forwarded unchanged. It does not move nested values into URL query settings. For these documented position settings, leave it out and use queryParams directly.

View raw JSON

{
  "type": "object",
  "required": [],
  "properties": {
    "queryParams": {
      "type": "object",
      "properties": {
        "query": {
          "type": "object",
          "required": [],
          "properties": {}
        }
      }
    }
  },
  "additionalProperties": false
}

Result schema

No fixed output contract is available. Field types reflect saved result evidence; individual responses can differ.

Result schema
Field / Path	Type	Meaning
Position records in this page`result.positions`	`array`	Available position records returned in this response. A page can contain multiple wallets and zero-share records; it is not a complete portfolio.
Position profit or loss`result.positions[].pnl`	`object`	The source’s realized and unrealized position P&L. Monetary amounts use USD; the percentage is a separate measure.
Realized P&L in USD`result.positions[].pnl.realized_usd`	`number`	Source-calculated realized position profit or loss in USD, distinct from unrealized changes and current value. Its aggregation period is unspecified.
Unrealized P&L percentage`result.positions[].pnl.unrealized_pct`	`number`	Unrealized position P&L already expressed as a percentage. Keep the supplied value; the denominator and calculation are unspecified.
Unrealized P&L in USD`result.positions[].pnl.unrealized_usd`	`number`	Source unrealized profit or loss for this position in USD, separate from realized P&L and current valuation.
Wallet address`result.positions[].user`	`string`	Wallet address associated with the position. An address alone does not identify a verified person.
Market and outcome context`result.positions[].market`	`object`	Identifiers, title, outcome side and label, and source status for the market outcome associated with this position.
Outcome side code`result.positions[].market.side`	`string`	The source’s YES or NO code for this position; read it alongside the human outcome label.
Market title`result.positions[].market.title`	`string`	Title or question of the market associated with this outcome position.
Outcome status`result.positions[].market.status`	`string`	Source status: open, resolved_win or resolved_loss. A win/loss outcome does not determine the sign of net trading P&L or guarantee redeemability.
Outcome token ID`result.positions[].market.token_id`	`string`	Token identifier for this specific outcome, distinct from the market condition ID and wallet address.
Outcome label`result.positions[].market.side_label`	`string`	Human-readable label for the position’s outcome, which may be more descriptive than YES or NO.
Market text identifier`result.positions[].market.market_slug`	`string`	The source’s market slug. This text identifier is not a complete page URL.
Market condition ID`result.positions[].market.condition_id`	`string`	Condition identifier of the market, distinct from its individual outcome token ID.
Reported valuation`result.positions[].current`	`object`	Price and USD value supplied by the source for this position. Freshness is not guaranteed by the current label.
Reported market price`result.positions[].current.price`	`number`	Source market price described on a 0–1 scale. Preserve it without inferring a probability conversion, price currency or guaranteed fill.
Position value in USD`result.positions[].current.value_usd`	`number`	Source valuation of this position in USD; it is not wallet cash, realized P&L or an amount available to withdraw.
Position quantity and costs`result.positions[].position`	`object`	Held shares, entry price, cost basis, lifetime buying expenditure and net taker fees for this record.
Currently held shares`result.positions[].position.shares`	`number`	Number of shares held in this record. Closed positions can have zero shares; do not determine status from quantity alone.
Net taker fees in USD`result.positions[].position.net_fees_usd`	`number`	Taker fees charged minus fees refunded for this position, in USD. Keep actual zero or negative values; do not fill a missing value from the source default.
Position cost basis in USD`result.positions[].position.total_cost_usd`	`number`	Source cost basis in USD. Distinguish it from lifetime purchase expenditure and the position’s current valuation; the precise calculation is unspecified.
Average entry price`result.positions[].position.avg_entry_price`	`number`	Source average entry price described on a 0–1 scale. It is not an automatically converted percentage or an independently stated USD amount.
Lifetime purchase spending in USD`result.positions[].position.total_bought_usd`	`number`	Cumulative USD ever spent buying this position, retained after redemption. It is distinct from current shares, cost basis and valuation.
Deprecated cumulative bought shares`result.positions[].position.total_shares_bought`	`number`	Deprecated quantity that can be approximate after a position is fully closed and reopened at another price. Do not treat it as an exact lifetime share total; total_bought_usd is a separate monetary measure.
Last position update timestamp`result.positions[].last_updated_at`	`number`	Timestamp of the last position update; it may be absent or null. Its output scale does not explicitly state seconds or milliseconds: confirm before date conversion, and distinguish it from request completion.
Last position update block`result.positions[].last_updated_block`	`number`	Block number associated with the last position update; it may be absent or null. It is not a timestamp or a confirmation of chain finality.
Position page information`result.pagination`	`object`	Record count, requested limit and possible continuation for this response; these describe a page rather than the whole collection.
Records returned in this page`result.pagination.count`	`number`	Number of position records in this response, not unique wallets, markets, trades or all available positions.
Requested position page size`result.pagination.limit`	`number`	Record-page limit reported for this request. The source default is 100; the returned count can be smaller.
More position data available`result.pagination.has_more`	`boolean`	Whether the source indicates more records after this page. It provides neither a total count nor an automatic next-page request.
Next-page cursor`result.pagination.pagination_key`	`string`	Actual source continuation key, which may be absent or null. Preserve it as an opaque value instead of decoding controls or inventing a cursor or expiry guarantee.

Additional notes

Distinguish the monetary measures

Cost basis, lifetime buying expenditure and current valuation answer different questions. Cumulative purchase spending remains a lifetime measure after redemption; current value is a source valuation, rather than cash available to withdraw. Read realized and unrealized USD profit or loss separately, and keep the supplied percentage without reconstructing a return formula.

Read outcome and update context

A resolved outcome can be marked as a win or loss while trading profit or loss has a different sign. Read the position’s reported P&L as well as its outcome status. A zero share count can appear in the returned records; use the recorded status and context rather than classifying the record from quantity alone.

Optional timestamp query bounds use Unix seconds and include the boundary. The output’s last-update timestamp does not explicitly state seconds or milliseconds, so confirm that unit before converting it to a date. A last-update block number is separate from a timestamp and from request completion. The record’s update metadata does not establish when its valuation was refreshed.

Use the page as a partial view

The official positions documentation specifies a default page size of 100 and sorting by update block in descending order. These defaults do not make the response a complete portfolio or transaction history. The count describes records in this page, and a cursor or more-data flag does not fetch another page automatically.

View Polymarket position records | BlockRun

View Polymarket position records | BlockRun

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Distinguish the monetary measures

Read outcome and update context

Use the page as a partial view

Start with no details

Understand each item

Continue when you need more