Skip to main content
GET
/
polymarket
/
tags
/
{identifier}
Get tag by slug
curl --request GET \
  --url https://api.struct.to/v1/polymarket/tags/{identifier}
{
  "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
}

Path Parameters

identifier
string
required

Tag ID or slug

Query Parameters

include_metrics
boolean

Attach analytics metrics. +1 credit.

timeframe
enum<string>

Metrics window. Default 1d (= 24h). Ignored unless include_metrics=true. 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

Response

Tag details

A Polymarket tag from the Gamma API

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