Get tag by slug

Retrieve a single tag by its ID or slug. Pass include_metrics=true to attach analytics metrics (volume_usd, shares_volume, txn_count, unique_traders, unique_makers, unique_takers, fees_usd, and builder metrics). Use timeframe to select the window; defaults to 1d.

GET /polymarket/tags/{identifier}

Get tag by slug

cURL

curl --request GET \
  --url https://api.struct.to/v1/polymarket/tags/{identifier}

200

{
  "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.

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

200

application/json

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>