Global combo analytics timeseries (cumulative)

curl --request GET \
  --url https://api.struct.to/v1/polymarket/combos/analytics/timeseries

import requests

url = "https://api.struct.to/v1/polymarket/combos/analytics/timeseries"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.struct.to/v1/polymarket/combos/analytics/timeseries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.struct.to/v1/polymarket/combos/analytics/timeseries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.struct.to/v1/polymarket/combos/analytics/timeseries"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.struct.to/v1/polymarket/combos/analytics/timeseries")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.struct.to/v1/polymarket/combos/analytics/timeseries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "t": 1,
    "v": 123,
    "bv": 123,
    "sv": 123,
    "sh": 123,
    "bsh": 123,
    "ssh": 123,
    "f": 123,
    "bf": 123,
    "buv": 123,
    "bubv": 123,
    "busv": 123,
    "bsv": 123,
    "bsbv": 123,
    "bssv": 123,
    "tc": 1,
    "bc": 1,
    "sc": 1,
    "btc": 1,
    "bbc": 1,
    "bsc": 1,
    "cre": 1,
    "exe": 1,
    "su": 1,
    "ps": 1,
    "pm": 1,
    "soc": 1,
    "moc": 1,
    "ext": 1,
    "inj": 1,
    "ctyb": 1,
    "mfyb": 1,
    "cmp": 1,
    "red": 1,
    "wr": 1,
    "uw": 1,
    "hs": 1,
    "hm": 1,
    "pc": 1,
    "mig": 1,
    "yv": 123,
    "ysh": 123,
    "ybsh": 123,
    "yssh": 123,
    "nv": 123,
    "nsh": 123,
    "l2t": 1,
    "l2v": 123,
    "l3t": 1,
    "l3v": 123,
    "l4t": 1,
    "l4v": 123,
    "l5t": 1,
    "l5v": 123,
    "epw": 123,
    "scu": 123,
    "mcu": 123,
    "rpu": 123,
    "ccu": 123,
    "ccr": 1,
    "cry": 1,
    "crn": 1,
    "nct": 1,
    "nbct": 1
  }
]

GET

polymarket

combos

analytics

timeseries

Global combo analytics timeseries (cumulative)

curl --request GET \
  --url https://api.struct.to/v1/polymarket/combos/analytics/timeseries

import requests

url = "https://api.struct.to/v1/polymarket/combos/analytics/timeseries"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.struct.to/v1/polymarket/combos/analytics/timeseries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.struct.to/v1/polymarket/combos/analytics/timeseries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.struct.to/v1/polymarket/combos/analytics/timeseries"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.struct.to/v1/polymarket/combos/analytics/timeseries")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.struct.to/v1/polymarket/combos/analytics/timeseries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "t": 1,
    "v": 123,
    "bv": 123,
    "sv": 123,
    "sh": 123,
    "bsh": 123,
    "ssh": 123,
    "f": 123,
    "bf": 123,
    "buv": 123,
    "bubv": 123,
    "busv": 123,
    "bsv": 123,
    "bsbv": 123,
    "bssv": 123,
    "tc": 1,
    "bc": 1,
    "sc": 1,
    "btc": 1,
    "bbc": 1,
    "bsc": 1,
    "cre": 1,
    "exe": 1,
    "su": 1,
    "ps": 1,
    "pm": 1,
    "soc": 1,
    "moc": 1,
    "ext": 1,
    "inj": 1,
    "ctyb": 1,
    "mfyb": 1,
    "cmp": 1,
    "red": 1,
    "wr": 1,
    "uw": 1,
    "hs": 1,
    "hm": 1,
    "pc": 1,
    "mig": 1,
    "yv": 123,
    "ysh": 123,
    "ybsh": 123,
    "yssh": 123,
    "nv": 123,
    "nsh": 123,
    "l2t": 1,
    "l2v": 123,
    "l3t": 1,
    "l3v": 123,
    "l4t": 1,
    "l4v": 123,
    "l5t": 1,
    "l5v": 123,
    "epw": 123,
    "scu": 123,
    "mcu": 123,
    "rpu": 123,
    "ccu": 123,
    "ccr": 1,
    "cry": 1,
    "crn": 1,
    "nct": 1,
    "nbct": 1
  }
]

Query Parameters

resolution

enum<string>

Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) Bucket size for /analytics/timeseries and /analytics/deltas responses. Each value picks the time interval that one row in the output covers: 60 = 1 hour, 240 = 4 hours, D/1D = 1 day, W/1W = 7 days, M/1M = calendar month.

Available options:

60,

240,

D,

1D,

W,

1W,

M,

1M

from

integer<int64>

Start timestamp (Unix seconds). Omit for all-time.

integer<int64>

End timestamp (Unix seconds)

count_back

integer<int32>

Max data points (default: 500, max: 2500)

pagination_key

string

Cursor from previous response for next page

Response

200 - application/json

Cumulative time-bucketed combo analytics

integer<int32>

required

Full field: bucket. Bucket start time as Unix seconds.

Required range: x >= 0

number<double>

required

Full field: usd_volume. Cumulative USD volume across combo fills (buys + sells).

number<double>

required

Full field: usd_buy_volume. Cumulative USD buy volume.

number<double>

required

Full field: usd_sell_volume. Cumulative USD sell volume.

number<double>

required

Full field: shares_volume. Cumulative combo shares volume (buys + sells).

bsh

number<double>

required

Full field: shares_buy_volume. Cumulative combo shares buy volume.

ssh

number<double>

required

Full field: shares_sell_volume. Cumulative combo shares sell volume.

number<double>

required

Full field: fees. Cumulative fees in USD.

number<double>

required

Full field: builder_fees. Cumulative builder fees in USD.

buv

number<double>

required

Full field: builder_usd_volume. Cumulative USD volume on builder-attributed fills.

bubv

number<double>

required

Full field: builder_usd_buy_volume. Cumulative builder USD buy volume.

busv

number<double>

required

Full field: builder_usd_sell_volume. Cumulative builder USD sell volume.

bsv

number<double>

required

Full field: builder_shares_volume. Cumulative builder combo shares volume.

bsbv

number<double>

required

Full field: builder_shares_buy_volume. Cumulative builder combo shares buy volume.

bssv

number<double>

required

Full field: builder_shares_sell_volume. Cumulative builder combo shares sell volume.

integer<int64>

required

Full field: txns. Cumulative combo fill transaction count.

Required range: x >= 0

integer<int64>

required

Full field: buys. Cumulative combo buy fill count.

Required range: x >= 0

integer<int64>

required

Full field: sells. Cumulative combo sell fill count.

Required range: x >= 0

btc

integer<int64>

required

Full field: builder_txns. Cumulative builder combo fill transaction count.

Required range: x >= 0

bbc

integer<int64>

required

Full field: builder_buys. Cumulative builder combo buy fill count.

Required range: x >= 0

bsc

integer<int64>

required

Full field: builder_sells. Cumulative builder combo sell fill count.

Required range: x >= 0

cre

integer<int64>

required

Full field: creations. Cumulative combo market creations.

Required range: x >= 0

exe

integer<int64>

required

Full field: executions. Cumulative combo executions.

Required range: x >= 0

integer<int64>

required

Full field: status_updates. Cumulative combo status updates.

Required range: x >= 0

integer<int64>

required

Full field: positions_split. Cumulative positions-split lifecycle operations.

Required range: x >= 0

integer<int64>

required

Full field: positions_merged. Cumulative positions-merged lifecycle operations.

Required range: x >= 0

soc

integer<int64>

required

Full field: split_on_condition. Cumulative split-on-condition lifecycle operations.

Required range: x >= 0

moc

integer<int64>

required

Full field: merged_on_condition. Cumulative merge-on-condition lifecycle operations.

Required range: x >= 0

ext

integer<int64>

required

Full field: extracted. Cumulative extract lifecycle operations.

Required range: x >= 0

inj

integer<int64>

required

Full field: injected. Cumulative inject lifecycle operations.

Required range: x >= 0

ctyb

integer<int64>

required

Full field: converted_to_yes_basket. Cumulative convert-to-YES-basket lifecycle operations.

Required range: x >= 0

mfyb

integer<int64>

required

Full field: merged_from_yes_basket. Cumulative merge-from-YES-basket lifecycle operations.

Required range: x >= 0

cmp

integer<int64>

required

Full field: compressed. Cumulative compress lifecycle operations.

Required range: x >= 0

red

integer<int64>

required

Full field: redeemed. Cumulative redemption lifecycle operations.

Required range: x >= 0

integer<int64>

required

Full field: wrapped. Cumulative wrap lifecycle operations.

Required range: x >= 0

integer<int64>

required

Full field: unwrapped. Cumulative unwrap lifecycle operations.

Required range: x >= 0

integer<int64>

required

Full field: horizontal_split. Cumulative horizontal-split lifecycle operations.

Required range: x >= 0

integer<int64>

required

Full field: horizontal_merge. Cumulative horizontal-merge lifecycle operations.

Required range: x >= 0

integer<int64>

required

Full field: position_converted. Cumulative position-converted lifecycle operations.

Required range: x >= 0

mig

integer<int64>

required

Full field: migrated. Cumulative migrate lifecycle operations.

Required range: x >= 0

number<double>

required

Full field: yes_usd_volume. Cumulative USD volume on the YES side.

ysh

number<double>

required

Full field: yes_shares_volume. Cumulative YES shares volume (buys + sells).

ybsh

number<double>

required

Full field: yes_shares_buy_volume. Cumulative YES shares buy volume.

yssh

number<double>

required

Full field: yes_shares_sell_volume. Cumulative YES shares sell volume.

number<double>

required

Full field: no_usd_volume. Cumulative USD volume on the NO side.

nsh

number<double>

required

Full field: no_shares_volume. Cumulative NO shares volume.

l2t

integer<int64>

required

Full field: legs_2_txns. Cumulative fill count on 2-leg combos.

Required range: x >= 0

l2v

number<double>

required

Full field: legs_2_usd_volume. Cumulative USD volume on 2-leg combos.

l3t

integer<int64>

required

Full field: legs_3_txns. Cumulative fill count on 3-leg combos.

Required range: x >= 0

l3v

number<double>

required

Full field: legs_3_usd_volume. Cumulative USD volume on 3-leg combos.

l4t

integer<int64>

required

Full field: legs_4_txns. Cumulative fill count on 4-leg combos.

Required range: x >= 0

l4v

number<double>

required

Full field: legs_4_usd_volume. Cumulative USD volume on 4-leg combos.

l5t

integer<int64>

required

Full field: legs_5_plus_txns. Cumulative fill count on combos with 5+ legs.

Required range: x >= 0

l5v

number<double>

required

Full field: legs_5_plus_usd_volume. Cumulative USD volume on combos with 5+ legs.

epw

number<double>

required

Full field: entry_price_usd_weighted_sum. Cumulative sum of entry price x USD size across fills (VWAP numerator).

scu

number<double>

required

Full field: split_collateral_usd. Cumulative collateral locked via splits, in USD.

mcu

number<double>

required

Full field: merge_collateral_usd. Cumulative collateral released via merges, in USD.

rpu

number<double>

required

Full field: redemption_payout_usd. Cumulative redemption payouts in USD.

ccu

number<double>

required

Full field: compress_collateral_usd. Cumulative collateral released via compress operations, in USD.

ccr

integer<int64>

required

Full field: combos_created. Cumulative combo markets created.

Required range: x >= 0

cry

integer<int64>

required

Full field: combos_resolved_yes. Cumulative combos resolved YES.

Required range: x >= 0

crn

integer<int64>

required

Full field: combos_resolved_no. Cumulative combos resolved NO.

Required range: x >= 0

nct

integer<int64>

required

Full field: new_combo_traders. Cumulative first-time combo traders.

Required range: x >= 0

nbct

integer<int64>

required

Full field: new_builder_combo_traders. Cumulative first-time builder-attributed combo traders.

Required range: x >= 0

Last modified on July 28, 2026

Global combo analytics candles (per-bucket deltas)

Get combo candlesticks

Introduction

Market

Events

Series

Trader

Combos

Holders

Order Book

Builders

Tags

Analytics

Assets

Bonds

Search

Global combo analytics timeseries (cumulative)

Query Parameters

Response