List builders ranked by activity

curl --request GET \
  --url https://api.struct.to/v1/polymarket/builders

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.struct.to/v1/polymarket/builders",
  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/builders"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.struct.to/v1/polymarket/builders")

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

[
  {
    "builder_code": "<string>",
    "block": 1,
    "ts": 1,
    "volume_usd": 123,
    "buy_volume_usd": 123,
    "sell_volume_usd": 123,
    "unique_traders": 1,
    "unique_makers": 1,
    "unique_takers": 1,
    "txn_count": 1,
    "buy_count": 1,
    "sell_count": 1,
    "fees_usd": 123,
    "builder_fees": 123,
    "shares_volume": 123,
    "yes_volume_usd": 123,
    "no_volume_usd": 123,
    "yes_count": 1,
    "no_count": 1,
    "buy_dist_under_10": 1,
    "buy_dist_10_100": 1,
    "buy_dist_100_1k": 1,
    "buy_dist_1k_10k": 1,
    "buy_dist_10k_50k": 1,
    "buy_dist_50k_plus": 1,
    "new_users": 1,
    "avg_rev_per_user": 123,
    "avg_vol_per_user": 123,
    "builder_maker_fee_rate_bps": 1,
    "builder_taker_fee_rate_bps": 1,
    "metadata": {
      "name": "<string>",
      "website": "<string>",
      "twitter": "<string>",
      "icon_url": "<string>",
      "description": "<string>"
    }
  }
]

GET

polymarket

builders

List builders ranked by activity

curl --request GET \
  --url https://api.struct.to/v1/polymarket/builders

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.struct.to/v1/polymarket/builders",
  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/builders"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.struct.to/v1/polymarket/builders")

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

[
  {
    "builder_code": "<string>",
    "block": 1,
    "ts": 1,
    "volume_usd": 123,
    "buy_volume_usd": 123,
    "sell_volume_usd": 123,
    "unique_traders": 1,
    "unique_makers": 1,
    "unique_takers": 1,
    "txn_count": 1,
    "buy_count": 1,
    "sell_count": 1,
    "fees_usd": 123,
    "builder_fees": 123,
    "shares_volume": 123,
    "yes_volume_usd": 123,
    "no_volume_usd": 123,
    "yes_count": 1,
    "no_count": 1,
    "buy_dist_under_10": 1,
    "buy_dist_10_100": 1,
    "buy_dist_100_1k": 1,
    "buy_dist_1k_10k": 1,
    "buy_dist_10k_50k": 1,
    "buy_dist_50k_plus": 1,
    "new_users": 1,
    "avg_rev_per_user": 123,
    "avg_vol_per_user": 123,
    "builder_maker_fee_rate_bps": 1,
    "builder_taker_fee_rate_bps": 1,
    "metadata": {
      "name": "<string>",
      "website": "<string>",
      "twitter": "<string>",
      "icon_url": "<string>",
      "description": "<string>"
    }
  }
]

Query Parameters

sort

enum<string>

Metric to sort by. Default: volume. Sort metric for the builders list endpoint.

Available options:

volume,

txns,

traders,

fees,

builder_fees,

new_users,

avg_rev_per_user,

avg_vol_per_user,

builder_maker_fee_rate_bps,

builder_taker_fee_rate_bps

sort_desc

boolean

Sort direction (default: true = highest first).

timeframe

enum<string>

Window to rank over. Default: lifetime. Time window for cumulative builder stats.

Available options:

lifetime,

1d,

7d,

30d

limit

integer<int64>

Max rows to return (default 50, max 500).

offset

integer<int64>

Number of rows to skip. Default 0. Takes precedence over pagination_key.

pagination_key

string

Opaque cursor from a previous response. Ignored when offset is set.

Response

200 - application/json

Ranked list of builders, each with embedded display metadata.

builder_code

string

required

Builder code.

block

integer<int64>

required

Latest block number for the metric snapshot.

Required range: x >= 0

integer<int32>

required

Unix timestamp in seconds.

Required range: x >= 0

volume_usd

number<double>

required

Volume in USD.

buy_volume_usd

number<double>

required

Buy volume in USD.

sell_volume_usd

number<double>

required

Sell volume in USD.

unique_traders

integer<int64>

required

Unique traders.

Required range: x >= 0

unique_makers

integer<int64>

required

Unique makers.

Required range: x >= 0

unique_takers

integer<int64>

required

Unique takers.

Required range: x >= 0

txn_count

integer<int64>

required

Transaction count.

Required range: x >= 0

buy_count

integer<int64>

required

Buy count.

Required range: x >= 0

sell_count

integer<int64>

required

Sell count.

Required range: x >= 0

fees_usd

number<double>

required

Fees in USD.

builder_fees

number<double>

required

Builder fees.

shares_volume

number<double>

required

Shares volume.

yes_volume_usd

number<double>

required

Yes volume in USD.

no_volume_usd

number<double>

required

No volume in USD.

yes_count

integer<int64>

required

Yes count.

Required range: x >= 0

no_count

integer<int64>

required

No count.

Required range: x >= 0

buy_dist_under_10

integer<int64>

required

Buy trade count in the under-10 USD bucket.

Required range: x >= 0

buy_dist_10_100

integer<int64>

required

Buy trade count in the 10-100 USD bucket.

Required range: x >= 0

buy_dist_100_1k

integer<int64>

required

Buy trade count in the 100-1k USD bucket.

Required range: x >= 0

buy_dist_1k_10k

integer<int64>

required

Buy trade count in the 1k-10k USD bucket.

Required range: x >= 0

buy_dist_10k_50k

integer<int64>

required

Buy trade count in the 10k-50k USD bucket.

Required range: x >= 0

buy_dist_50k_plus

integer<int64>

required

Buy trade count in the 50k-plus USD bucket.

Required range: x >= 0

new_users

integer<int64>

required

New users.

Required range: x >= 0

avg_rev_per_user

number<double>

required

Average revenue per user — builder_fees / unique_traders.

avg_vol_per_user

number<double>

required

Average volume per user — volume_usd / unique_traders.

builder_maker_fee_rate_bps

integer<int32>

required

Builder's maker fee rate in basis points. Same value across all timeframes — this is a property of the builder, not a windowed metric.

Required range: x >= 0

builder_taker_fee_rate_bps

integer<int32>

required

Builder's taker fee rate in basis points. Same scoping as builder_maker_fee_rate_bps.

Required range: x >= 0

metadata

null | object

Builder display metadata (name, links, icon URL, description). null when no metadata has been registered for this builder.

Show child attributes

Last modified on August 7, 2026

Introduction

Market

Events

Series

Trader

Combos

Holders

Order Book

Builders

Tags

Analytics

Assets

Bonds

Search

List builders ranked by activity

Query Parameters

Response