GET /wallets

Query wallets by tag, date range, and sort order. The primary endpoint.

GET https://datasets.polynode.dev/api/datasets/sports-esports/wallets

The primary endpoint. Returns wallet addresses that traded in a specific sport category, with volume, fill count, maker/taker split, and markets traded. Supports filtering by tag and time range.

Query Parameters

Parameter	Type	Default	Description
tag	string	—	Filter by tag slug: sports, nfl, esports, soccer, boxing, tennis, ufc, mlb, baseball, nba, counter-strike-2.
after	integer	—	Only wallets active after this unix timestamp.
before	integer	—	Only wallets active before this unix timestamp.
sort	string	volume	Sort by: volume, fills, first_seen, last_seen, markets.
limit	integer	50	Results per page (max 500).
offset	integer	0	Pagination offset.

Example: All NFL wallets sorted by volume

curl "https://datasets.polynode.dev/api/datasets/sports-esports/wallets?tag=nfl&sort=volume&limit=5"

Example: Sports wallets active after Jan 1, 2025

curl "https://datasets.polynode.dev/api/datasets/sports-esports/wallets?tag=sports&after=1735689600&sort=volume&limit=10"

Response

{
  "wallets": [
    {
      "wallet": "0x204f72f35326db932158cba6adff0b9a1da95e14",
      "tag_slug": "sports",
      "fill_count": 374922,
      "total_volume_usdc": "72603487.44",
      "maker_fills": 72628,
      "taker_fills": 302294,
      "first_seen": 1761955252,
      "last_seen": 1777408494,
      "markets_traded": 52815
    }
  ],
  "count": 5,
  "limit": 5,
  "offset": 0
}

Response Fields

Field	Type	Description
wallet	string	Ethereum address (0x-prefixed, lowercase)
tag_slug	string	The sport/esport tag this row is aggregated for
fill_count	integer	Total fills (maker + taker combined)
total_volume_usdc	string	Total volume in USDC
maker_fills	integer	Fills where this wallet was the maker (liquidity provider)
taker_fills	integer	Fills where this wallet was the taker (liquidity consumer)
first_seen	integer	Unix timestamp of first trade
last_seen	integer	Unix timestamp of most recent trade
markets_traded	integer	Number of distinct markets (condition_ids) traded