Polymarket

Search markets, get prices, and trade on Polymarket prediction markets

Actions11

Price → Get

AI-generated

Summary

Retrieve the current price information for a specified Polymarket outcome token using its token ID. Optionally include additional pricing data such as midpoint price, bid/ask spread, and the full order book depth.

Inputs

  • Token ID (required) — The token ID of the Polymarket outcome token to fetch the current price for. This must be obtained from a market's outcome tokens.
  • Include Data — Optional array to specify which additional pricing details to include in the response: Midpoint price, bid/ask spread, and/or the full order book depth. By default, midpoint price is included.

Output shape

a single JSON object containing the tokenId and requested pricing details such as buy price, and optionally midpoint, spread, and order book data.

Returns an array with one output per input item, each containing a JSON object with the requested pricing data. Additional data fields are included based on the 'Include Data' parameter. Errors related to token ID or data retrieval will result in a failure unless error handling is enabled.

Examples

Example 1: Get current price for token with default midpoint data included

Token ID set to '0xabc123...'; Include Data set to ['midpoint'] (default). Output JSON will include price and midpoint.

Example 2: Get current price including spread and order book data

Token ID set to '0xabc123...'; Include Data set to ['midpoint', 'spread', 'orderBook']. Output JSON will include price, midpoint, spread, and full order book depth.

Links

Discussion