# Polymarket Single Token Price

> Polymarket Single Token Price is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.012/call, status unknown (last checked 2026-10-18).

Retrieves the best market price (bid or ask) for a specific Polymarket prediction market token.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/polymarket/price?utm_source=zero.xyz
- Price: $0.012/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Provider: AIsa MPP Data APIs
- Website: https://aisa.one
- Tags: web-search, financial-data, prediction-markets, weather, travel, data, search
- Canonical page: https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-single-token-price-8eff12fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mBYxJMhfMYNqHtM_AtT6G

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aisa-mpp-data-apis-polymarket-single-token-price-8eff12fc
```

Example prompt: What's the current best ask price on Polymarket for token ID 0x1234abcd...? I want to know what it'll cost me to buy that outcome.

## When to prefer this

Use this endpoint when you need the best single-side market price (bid or ask) for exactly one Polymarket token. Prefer this over the Midpoint endpoint when you need the actionable order-book price for a specific trade direction rather than the theoretical mid-price. Use the batch Prices endpoint instead if you need prices for multiple tokens simultaneously to save on per-call costs.

## Known failure modes

- Invalid or unknown token_id returns an error or empty result
- Missing required parameters (side or token_id) returns a 400 validation error
- Market may be closed or illiquid, returning no meaningful price
- Enum value for side must be exactly 'BUY' or 'SELL' — any other value will fail
- Transient upstream Polymarket API unavailability may cause 5xx errors

## How this service works

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.

<!-- aisa-pricing:start -->
Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Output

Returns a single numeric decimal value representing the best available market price — the best bid if the side is BUY, or the best ask if the side is SELL — for the specified Polymarket outcome token.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "side",
  "token_id"
 ],
 "properties": {
  "side": {
   "enum": [
    "BUY",
    "SELL"
   ],
   "type": "string",
   "description": "Order side"
  },
  "token_id": {
   "type": "string",
   "description": "Token ID (asset ID)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "price"
 ],
 "properties": {
  "price": {
   "type": "number",
   "format": "double",
   "example": 0.45,
   "description": "Market price as a decimal number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-single-token-price-8eff12fc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisa.one](https://www.zero.xyz/host/api.aisa.one/llms.txt)