Skip to main content
GET
/
polymarket
/
tags
Get tags
curl --request GET \
  --url https://api.struct.to/v1/polymarket/tags
[
  {
    "id": "",
    "label": "",
    "slug": null,
    "volume_usd": 123,
    "shares_volume": 123,
    "builder_usd_volume": 123,
    "builder_shares_volume": 123,
    "txn_count": 123,
    "builder_txn_count": 123,
    "unique_traders": 123,
    "unique_makers": 123,
    "unique_takers": 123,
    "unique_builder_traders": 123,
    "fees_usd": 123,
    "builder_fees_usd": 123
  }
]

Query Parameters

limit
integer<int32>

Results limit (default: 10, max: 250)

offset
integer<int64>

Offset-based pagination (number of results to skip). Takes precedence over pagination_key.

pagination_key
string

Cursor-based pagination key (alphabetical mode only).

sort
enum<string>

Sort metric. Defaults to volume when only timeframe is set. Setting either sort or timeframe adds +2 credits. Metric to order by when sort=<value> is provided.

unique_* variants rank by the number of distinct wallet addresses active in the selected timeframe.

Available options:
volume,
builder_volume,
shares_volume,
builder_shares_volume,
txns,
builder_txns,
unique_traders,
unique_builder_traders,
unique_makers,
unique_takers,
fees,
builder_fees
timeframe
enum<string>

Window for the sort metric. Defaults to 24h when only sort is set. Setting either sort or timeframe adds +2 credits. Timeframe for ?sort=... — defines the window the metric is summed over (or lifetime for all-time cumulative).

Available options:
lifetime,
1h,
24h,
7d,
30d,
1mo
sort_desc
boolean

Sort direction (default: true = highest first). Only applies to sort/timeframe mode.

Response

200 - application/json

List of all tags

id
string
default:""
label
string
default:""
slug
string | null
volume_usd
number<double>
shares_volume
number<double>
builder_usd_volume
number<double>
builder_shares_volume
number<double>
txn_count
integer<int64>
builder_txn_count
integer<int64>
unique_traders
integer<int64>

Distinct active traders in the window.

unique_makers
integer<int64>
unique_takers
integer<int64>
unique_builder_traders
integer<int64>
fees_usd
number<double>
builder_fees_usd
number<double>
Last modified on June 17, 2026