> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Polymarket: Get Price

> Reading the current best BUY or SELL price for one outcome token. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Reading the current best BUY or SELL price for one outcome token.

<Info>
  Tool ID: `polymarket_get_price`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'polymarket_get_price',
  {
    "token_id": "token_123",
    "side": "BUY"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={null}
deepline tools execute polymarket_get_price --input '{
  "token_id": "token_123",
  "side": "BUY"
}' --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "data": {
    "price": "example"
  }
}
```

Use `deepline tools get polymarket_get_price --json` for the latest machine-readable contract.

## Input reference

Retrieves the best market price for a specific token ID and side (bid or ask). Returns the best bid price for BUY side or best ask price for SELL side.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.token_id` | `string` | Yes | — | Token ID (asset ID) |
| `payload.side` | `"BUY" \| "SELL"` | Yes | — | Order side Allowed: `BUY`, `SELL`. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Retrieves the best market price for a specific token ID and side (bid or ask). Returns the best bid price for BUY side or best ask price for SELL side.",
    "properties": {
      "token_id": {
        "type": "string",
        "description": "Token ID (asset ID)"
      },
      "side": {
        "type": "string",
        "description": "Order side",
        "enum": [
          "BUY",
          "SELL"
        ]
      }
    },
    "required": [
      "token_id",
      "side"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.price` | `string` | Yes | — | Best price for the side as a decimal string, 0 to 1. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "price": {
            "type": "string",
            "description": "Best price for the side as a decimal string, 0 to 1."
          }
        },
        "required": [
          "price"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Polymarket provider guide](/docs/providers/polymarket/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.