Skip to main content
GET
/
v1
/
polymarket
/
markets
/
{condition_id}
/
open_interest
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/markets/0x1234.../open_interest?granularity=day"

{
  "condition_id": "0x1a2b3c4d...",
  "granularity": "week",
  "start_time": 1704067200,
  "end_time": 1735689600,
  "open_interest_over_time": [
    {
      "timestamp": 1704067200,
      "open_interest_usd": 5250000.00
    },
    {
      "timestamp": 1704672000,
      "open_interest_usd": 5890000.00
    },
    {
      "timestamp": 1705276800,
      "open_interest_usd": 6120000.00
    }
  ]
}

​
Overview

Fetch historical time series of open interest for a market. Open interest represents the total value of tokens circulating from split, merge, redeem, and conversion events.
​
condition_id
string
required
The condition ID for the market
​
granularity
string
default:"day"
Time granularity: day, week, month, year, or all
​
start_time
integer
Unix timestamp (seconds) for start of range
​
end_time
integer
Unix timestamp (seconds) for end of range
​
condition_id
string
The requested condition ID
​
granularity
string
The time granularity used
​
start_time
integer
Actual start time of returned data
​
end_time
integer
Actual end time of returned data
​
open_interest_over_time
array
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/markets/0x1234.../open_interest?granularity=day"

{
  "condition_id": "0x1a2b3c4d...",
  "granularity": "week",
  "start_time": 1704067200,
  "end_time": 1735689600,
  "open_interest_over_time": [
    {
      "timestamp": 1704067200,
      "open_interest_usd": 5250000.00
    },
    {
      "timestamp": 1704672000,
      "open_interest_usd": 5890000.00
    },
    {
      "timestamp": 1705276800,
      "open_interest_usd": 6120000.00
    }
  ]
}

​
Understanding Open Interest

Open Interest differs from volume:
  • Volume: Total USD traded over time (cumulative)
  • Open Interest: Current outstanding positions (can go up or down)
Open interest increases when:
  • New positions are created (splits)
  • Collateral is converted to shares
Open interest decreases when:
  • Positions are redeemed or merged
  • Markets are resolved

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get your free key at dashboard.predexon.com

Path Parameters

​
condition_id
string
required

Condition ID for the market

Query Parameters

​
granularity
enum<string>
default:day

Time granularity

Available options:
day,
week,
month,
year,
all
​
start_time
integer | null

Unix timestamp (seconds) for start

​
end_time
integer | null

Unix timestamp (seconds) for end

Response

Successful Response

Market open interest time series endpoint response.

​
condition_id
string
required
​
granularity
enum<string>
required

PnL granularity enum.

Available options:
day,
week,
month,
year,
all
​
start_time
integer
required
​
end_time
integer
required
​
open_interest_over_time
OpenInterestDataPoint · object[]
required