Get Trader Intelligence Profile

Fetches trader identity dossier, pUSD balance, taker tier, and top category tag breakdowns

GEThttps://api.polyedge.dev/v2/traders/{address}

请求参数

该接口所需的请求头与参数规范。

请求头

请求头	类型	必填	说明
X-PolyEdge-Key	string	必填	PolyEdge API Key for client authentication and rate-limiting

路径参数

参数	类型	必填	说明
address	string	必填	EVM address (0x...)

查询参数

参数	类型	默认值	说明
tag	string	all	Market category tag filter (e.g. sports, crypto, politics, all)
series	string	-	Optional series slug filter

响应 (200 OK)

成功响应载荷的字段定义。

application/json

200 响应示例

json

{
  "profile": {
    "address": "0x2005d16a84ceefa912d4e380cd32e7ff827875ea",
    "name": "RN1",
    "profile_created_at": "2024-12-12T16:25:53.777762Z",
    "profile_image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/profile-image-1567750-84001aec-310a-470f-9584-67dfcaa61267.png",
    "x_username": "RN1polymarket"
  },
  "pusd_balance": 2081936002558,
  "taker_tier": 6,
  "taker_tier_name": "Obsidian",
  "top_tags": [
    {
      "maker_volume": 61838925540684,
      "markets_count": 26444,
      "pnl": 303196270634,
      "roi": 0.56,
      "slug": "sports",
      "taker_volume": 16347020993305,
      "volume": 78185946533989,
      "win_rate": 48.03,
      "wins_count": 12701
    },
    {
      "maker_volume": 24516759261273,
      "markets_count": 17625,
      "pnl": 247296375870,
      "roi": 1.11,
      "slug": "soccer",
      "taker_volume": 4537968937546,
      "volume": 29054728198819,
      "win_rate": 49.1,
      "wins_count": 8654
    },
    {
      "maker_volume": 5741683388365,
      "markets_count": 1114,
      "pnl": 30340241710,
      "roi": 0.47,
      "slug": "esports",
      "taker_volume": 3879003457064,
      "volume": 9620686845429,
      "win_rate": 53.32,
      "wins_count": 594
    },
    {
      "maker_volume": 5741683388365,
      "markets_count": 1114,
      "pnl": 30340241710,
      "roi": 0.47,
      "slug": "counter-strike-2",
      "taker_volume": 3879003457064,
      "volume": 9620686845429,
      "win_rate": 53.32,
      "wins_count": 594
    },
    {
      "maker_volume": 204922860832,
      "markets_count": 87,
      "pnl": 13597989650,
      "roi": 9.64,
      "slug": "basketball",
      "taker_volume": 0,
      "volume": 204922860832,
      "win_rate": 60.92,
      "wins_count": 53
    }
  ],
  "weighted_volume": 6185561.210108,
  "last_trade_at": "2026-09-29T08:59:42Z"
}

响应体字段

字段	类型	说明
profile	object	-
├─address	string	Checksummed 0x-prefixed EVM wallet address
├─name	string	Custom display name or Polymarket profile username
├─profile_created_at	string	ISO 8601 UTC timestamp of Polymarket profile creation
├─profile_image	string	Public avatar image URL
├─x_username	string	Linked X (formerly Twitter) social handle
pusd_balance	integer	Trader's pUSD balance in micro-pUSD (6 decimals, e.g. 1000000 = 1 pUSD)
taker_tier	integer	Polymarket Taker Rebate Program tier level (0-6: 0=Tier 0, 1=Bronze, 2=Silver, 3=Gold, 4=Platinum, 5=Diamond, 6=Obsidian)
taker_tier_name	string	Descriptive taker rebate tier name ("Tier 0", "Bronze", "Silver", "Gold", "Platinum", "Diamond", "Obsidian", or empty string if unsynced)
top_tags	array of objects	Performance breakdown across top 5 categories in last 30 days
├─maker_volume	integer	Passive maker volume in micro-USD (6 decimals)
├─markets_count	integer	Number of markets traded in this tag
├─pnl	integer	Realized net PnL in micro-USD (6 decimals)
├─roi	number	Return on investment percentage for this tag
├─slug	string	Category tag URL slug (e.g. "crypto", "politics", "sports")
├─taker_volume	integer	Aggressive taker volume in micro-USD (6 decimals)
├─volume	integer	Aggregated trading volume in micro-USD (6 decimals)
├─win_rate	number	Win rate percentage for this tag (0.0 to 100.0)
├─wins_count	integer	Number of profitable markets in this tag
weighted_volume	number	Rolling 30-day taker Weighted Volume (wV) in USD, calculated by Trade Size * (1 - Entry Price) * Category Weight * Bonuses
last_trade_at	string	ISO 8601 UTC timestamp of trader's most recent trade across the platform

cURL 示例

在终端中直接复制并运行此命令测试该接口。

cURL: GET /v2/traders/{address}

bash

curl -X GET "https://api.polyedge.dev/v2/traders/0x2005d16a84ceefa912d4e380cd32e7ff827875ea?tag=all" \
  -H "X-PolyEdge-Key: Your-PolyEdge-ApiKey"