Prediction Market Positions

GET https://api.unusualwhales.com/api/predictions/market/{asset_id}/positions

Request

Security: Bearer Auth Authorization: Bearer <token>

Path Parameters

asset_id string required

Responses

200 404 422 500

Response Body 200 OK

amount string

Example: 5000

avg_price string

Example: 0.42

category_num_markets integer

Example: 24

category_score string

Example: 8.1

category_sum_invested string

Example: 42000

category_sum_pnl string

Example: 18500.75

category_win_rate string

Example: 0.65

invested_usd string

Example: 2100

position_start_at string

Example: 2026-07-10T14:05:00Z

realized_pnl string

Example: 350.25

smart_score string

Example: 12.5

tags array[string]

Example: []

total_bought string

Example: 6000

total_invested_usd string

Example: 2520

updated_at string

Example: 2026-07-29T18:32:11Z

user_address string

Example: 0x5140e6529f2108469c9386ad5acd7acb8cddae0c

Try It GET

API Token

Path Parameters

asset_id required

Request Sample

curl -X GET "https://api.unusualwhales.com/api/predictions/market/{asset_id}/positions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/predictions/market/{asset_id}/positions", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "amount": "5000",
      "avg_price": "0.42",
      "category_num_markets": 24,
      "category_score": "8.1",
      "category_sum_invested": "42000"
    }
  ]
}