Get Prediction Market Detail
Fetches standardized market metadata matching exporter format, total volume, distributed PnL, trader counts, and top 20 winners with execution orders (supports lookup by numeric ID, condition ID, or market slug)
GET/v2/markets/{id}
请求参数
该接口所需的请求头与参数规范。
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-PolyEdge-Key | string | 必填 | PolyEdge API Key for client authentication and rate-limiting |
路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 必填 | Polymarket market numeric ID, condition ID (0x...), or URL slug |
查询参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
include_orders | boolean | false | Include individual fill orders for top earners |
响应 (200 OK)
成功响应载荷的字段定义。
200 响应示例
json
{
"market": {
"condition_id": "0x7db55c63dc75f12b84a57c68f170df5a5059f408a8c2b412bcf9524d1f787ab5",
"created_at": "2026-09-17T01:59:03.835445Z",
"description": "This market refers to the tennis match between Livas Eduardo De Carvalho Damazio and Rafael Tosetto in the M15 Belém, Main Draw, originally scheduled for September 17, 2026 at 2:00PM ET.\n\nThis market will resolve to 'Livas Eduardo De Carvalho Damazio' if Livas Eduardo De Carvalho Damazio advances against Rafael Tosetto.\n\nThis market will resolve to 'Rafael Tosetto' if Rafael Tosetto advances against Livas Eduardo De Carvalho Damazio.\n\nIf the match is canceled (not played at all), ends in a tie, or a winner has not been determined by October 1, 2026, 11:59 PM ET (14 days after the scheduled start), this market will resolve to 50-50.\n\nIf the match begins but is not completed, and one player advances due to the opponent's retirement, default, or disqualification, this market will resolve to the player who advances.\n\nIf the match ends in a walkover (player withdraws before the start and the other advances automatically), this market will resolve to 50-50.\n\nThe primary resolution source will be official information from the International Tennis Federation (ITF). A consensus of credible reporting may also be used.",
"end_date": "2026-09-24T18:00:00Z",
"event_slug": "itf-damazi1-tosett1-2026-09-17",
"fee_schedule": {
"exponent": 1,
"rate": 0.05,
"takerOnly": true,
"rebateRate": 0.15
},
"fee_type": "sports_fees_v3",
"fees_enabled": true,
"group_item_threshold": 0,
"group_item_title": "",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/itf-5206dc6c54.png",
"id": 4629816,
"neg_risk": false,
"outcomes": [
"Livas Eduardo De Carvalho Damazio",
"Rafael Tosetto"
],
"question": "M15 Belém: Livas Eduardo De Carvalho Damazio vs Rafael Tosetto",
"resolution_source": "https://www.itftennis.com/en/tournament-calendar/",
"resolved_at": "2026-09-17T20:52:24Z",
"result": 100,
"series_slug": "itf",
"slug": "itf-damazi1-tosett1-2026-09-17",
"sports_market_type": "moneyline",
"start_date": "2026-09-17T01:59:15Z",
"tags_slug": [
"sports",
"tennis",
"games"
],
"token_ids": [
"6978806336379562351057856950103195723602843677964737322649402498791498745472",
"83554971497528118076782265748171238240640356130156587050220098500620716434680"
]
},
"top_earners": [
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 5000000,
"side": "BUY",
"time": "2026-09-17T18:14:27Z",
"usdc": 750000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 180538889,
"side": "BUY",
"time": "2026-09-17T18:29:04Z",
"usdc": 50550889
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 101802629,
"side": "BUY",
"time": "2026-09-17T18:37:12Z",
"usdc": 24432631
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 600000000,
"side": "BUY",
"time": "2026-09-17T18:37:27Z",
"usdc": 132000000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 26333332,
"side": "BUY",
"time": "2026-09-17T18:39:07Z",
"usdc": 6583333
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 5000000,
"side": "BUY",
"time": "2026-09-17T18:39:40Z",
"usdc": 1400000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 5000000,
"side": "BUY",
"time": "2026-09-17T19:00:27Z",
"usdc": 1600000
},
{
"fee": 4227970,
"is_taker": true,
"outcome": "Rafael Tosetto",
"shares": 345000000,
"side": "BUY",
"time": "2026-09-17T19:31:33Z",
"usdc": 148350000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Rafael Tosetto",
"shares": 28560000,
"side": "BUY",
"time": "2026-09-17T19:34:54Z",
"usdc": 8282400
},
{
"fee": 0,
"is_taker": false,
"outcome": "Rafael Tosetto",
"shares": 3588629,
"side": "BUY",
"time": "2026-09-17T19:37:21Z",
"usdc": 968930
},
{
"fee": 0,
"is_taker": false,
"outcome": "Rafael Tosetto",
"shares": 600053332,
"side": "BUY",
"time": "2026-09-17T19:37:57Z",
"usdc": 150013333
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 131000000,
"side": "BUY",
"time": "2026-09-17T19:46:19Z",
"usdc": 103490000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 197250000,
"side": "BUY",
"time": "2026-09-17T19:55:48Z",
"usdc": 149910000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 189000000,
"side": "BUY",
"time": "2026-09-17T20:06:42Z",
"usdc": 149310000
},
{
"fee": 49500,
"is_taker": true,
"outcome": "Rafael Tosetto",
"shares": 100000000,
"side": "BUY",
"time": "2026-09-17T20:18:45Z",
"usdc": 1000000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 20000000,
"side": "BUY",
"time": "2026-09-17T20:19:15Z",
"usdc": 16800000
}
],
"pnl": 511205864,
"profile": {
"address": "0xc07d5961e7a361992983c1a3a865d00dc28cb1df",
"name": "0xc07",
"profile_created_at": "2026-06-03T12:45:39.028575Z",
"profile_image": "",
"x_username": ""
},
"rank": 1,
"roi": 84.09067019222299,
"volume": 945441516
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 285000000,
"side": "BUY",
"time": "2026-09-17T18:13:51Z",
"usdc": 59850000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 9837500,
"side": "BUY",
"time": "2026-09-17T18:13:51Z",
"usdc": 1967500
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 30000000,
"side": "BUY",
"time": "2026-09-17T18:14:18Z",
"usdc": 5700000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 20150000,
"side": "BUY",
"time": "2026-09-17T18:14:18Z",
"usdc": 4030000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Rafael Tosetto",
"shares": 11483871,
"side": "BUY",
"time": "2026-09-17T18:27:22Z",
"usdc": 7923871
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 59997143,
"side": "BUY",
"time": "2026-09-17T18:28:36Z",
"usdc": 17999143
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 59997182,
"side": "BUY",
"time": "2026-09-17T18:28:40Z",
"usdc": 17399183
}
],
"pnl": 350112128,
"profile": {
"address": "0x67f3169b589e87a66142c6e15cf233c69832f5dc",
"name": "",
"profile_created_at": "",
"profile_image": "",
"x_username": ""
},
"rank": 2,
"roi": 327.37334508034,
"volume": 114869697
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 5000000,
"side": "BUY",
"time": "2026-09-17T18:14:19Z",
"usdc": 600000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 295000000,
"side": "BUY",
"time": "2026-09-17T19:31:33Z",
"usdc": 168150000
},
{
"fee": 5129250,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 547120000,
"side": "BUY",
"time": "2026-09-17T19:38:01Z",
"usdc": 410340000
},
{
"fee": 494760,
"is_taker": true,
"outcome": "Rafael Tosetto",
"shares": 54250000,
"side": "BUY",
"time": "2026-09-17T19:55:48Z",
"usdc": 13020000
},
{
"fee": 1304160,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 143000000,
"side": "SELL",
"time": "2026-09-17T19:55:48Z",
"usdc": 108680000
},
{
"fee": 1227660,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 148000000,
"side": "SELL",
"time": "2026-09-17T20:06:42Z",
"usdc": 116920000
},
{
"fee": 340090,
"is_taker": true,
"outcome": "Rafael Tosetto",
"shares": 41000000,
"side": "BUY",
"time": "2026-09-17T20:06:42Z",
"usdc": 8610000
}
],
"pnl": 172504080,
"profile": {
"address": "0x0d2d845a6ff64e31e04a70afce8a573940767ff5",
"name": "38791873984189",
"profile_created_at": "2026-05-04T13:57:20.312875Z",
"profile_image": "",
"x_username": ""
},
"rank": 3,
"roi": 29.78882039061286,
"volume": 826320000
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 50000000,
"side": "BUY",
"time": "2026-09-17T19:31:33Z",
"usdc": 28500000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Rafael Tosetto",
"shares": 10000000,
"side": "BUY",
"time": "2026-09-17T20:11:48Z",
"usdc": 1000000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 32800000,
"side": "SELL",
"time": "2026-09-17T20:11:48Z",
"usdc": 29520000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 50000000,
"side": "BUY",
"time": "2026-09-17T20:19:10Z",
"usdc": 46600000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 212000000,
"side": "BUY",
"time": "2026-09-17T20:19:10Z",
"usdc": 194502000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 162000000,
"side": "BUY",
"time": "2026-09-17T20:19:10Z",
"usdc": 145962000
}
],
"pnl": 54156000,
"profile": {
"address": "0x3ca9089f59d506a6773a4d68227a1ac97806424a",
"name": "Pan9X",
"profile_created_at": "2026-07-27T08:02:08.322213Z",
"profile_image": "",
"x_username": ""
},
"rank": 4,
"roi": 13.03192769344794,
"volume": 446084000
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 47164381,
"side": "BUY",
"time": "2026-09-17T18:47:51Z",
"usdc": 12734383
},
{
"fee": 0,
"is_taker": false,
"outcome": "Rafael Tosetto",
"shares": 882353,
"side": "BUY",
"time": "2026-09-17T18:48:30Z",
"usdc": 582353
},
{
"fee": 0,
"is_taker": false,
"outcome": "Rafael Tosetto",
"shares": 46000000,
"side": "BUY",
"time": "2026-09-17T20:11:48Z",
"usdc": 4600000
}
],
"pnl": 29247645,
"profile": {
"address": "0x7c1ee865a785de4c00ee90ed86a38489fb8bbab3",
"name": "CandleHammerDrums",
"profile_created_at": "2026-06-09T20:59:25.907525Z",
"profile_image": "",
"x_username": ""
},
"rank": 5,
"roi": 229.67461399582533,
"volume": 17916736
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 17389608,
"side": "BUY",
"time": "2026-09-17T16:04:37Z",
"usdc": 3999610
}
],
"pnl": 13389998,
"profile": {
"address": "0x631857e845695738b089cd0773fa16a0897146b1",
"name": "0x631857E845695738B089Cd0773Fa16A0897146B1-1778686442041",
"profile_created_at": "2026-05-13T15:34:03.240371Z",
"profile_image": "",
"x_username": ""
},
"rank": 6,
"roi": 334.782591302652,
"volume": 3999610
},
{
"orders": [
{
"fee": 249900,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 20000000,
"side": "BUY",
"time": "2026-09-17T19:15:12Z",
"usdc": 9800000
},
{
"fee": 86990,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 8450000,
"side": "BUY",
"time": "2026-09-17T19:35:09Z",
"usdc": 5999500
}
],
"pnl": 12313610,
"profile": {
"address": "0x357a66ab8e74fcc4287be206c73f5615631e951e",
"name": "kostyatech",
"profile_created_at": "2026-07-13T10:34:18.692604Z",
"profile_image": "",
"x_username": ""
},
"rank": 7,
"roi": 77.93670685781196,
"volume": 15799500
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 105000000,
"side": "BUY",
"time": "2026-09-17T20:19:10Z",
"usdc": 94500000
}
],
"pnl": 10500000,
"profile": {
"address": "0xa9f5e5c9c761a0c7d692ba479028f778a5dd937f",
"name": "Jxtoas",
"profile_created_at": "2025-12-21T03:50:29.647864Z",
"profile_image": "",
"x_username": ""
},
"rank": 8,
"roi": 11.11111111111111,
"volume": 94500000
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 120100000,
"side": "BUY",
"time": "2026-09-17T20:19:10Z",
"usdc": 111092500
}
],
"pnl": 9007500,
"profile": {
"address": "0xc4fe817476491890086330a639ac417d51bf601f",
"name": "poshposh",
"profile_created_at": "2025-04-06T19:22:06.945838Z",
"profile_image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/profile-image-2741777-5e9499b8-ffdc-4d98-a393-de4e957d3df6.png",
"x_username": ""
},
"rank": 9,
"roi": 8.108108108108109,
"volume": 111092500
},
{
"orders": [
{
"fee": 399600,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 88800000,
"side": "BUY",
"time": "2026-09-17T20:11:48Z",
"usdc": 79920000
},
{
"fee": 4430,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 88800000,
"side": "SELL",
"time": "2026-09-17T20:20:39Z",
"usdc": 88711200
}
],
"pnl": 8387170,
"profile": {
"address": "0xf3d3c029eea604047526d5615cf19795eb6e77a0",
"name": "llicius",
"profile_created_at": "2026-04-26T19:35:26.041842Z",
"profile_image": "",
"x_username": ""
},
"rank": 10,
"roi": 10.494456956956958,
"volume": 168631200
},
{
"orders": [
{
"fee": 334280,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 39600000,
"side": "BUY",
"time": "2026-09-17T19:43:46Z",
"usdc": 31082000
}
],
"pnl": 8183720,
"profile": {
"address": "0xfd3e6449d0c1e807501dcc17c0d9447201f35a7a",
"name": "User7429",
"profile_created_at": "2025-12-21T18:28:03.416427Z",
"profile_image": "",
"x_username": ""
},
"rank": 11,
"roi": 26.32945112927096,
"volume": 31082000
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 88000000,
"side": "BUY",
"time": "2026-09-17T20:19:10Z",
"usdc": 80080000
}
],
"pnl": 7920000,
"profile": {
"address": "0xda770326bd091d26f816917aa83a6baff668683f",
"name": "yyyrl",
"profile_created_at": "2026-04-29T13:43:20.743525Z",
"profile_image": "",
"x_username": ""
},
"rank": 12,
"roi": 9.89010989010989,
"volume": 80080000
},
{
"orders": [
{
"fee": 66000,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 5882353,
"side": "BUY",
"time": "2026-09-17T18:48:30Z",
"usdc": 2000000
},
{
"fee": 290,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 5880000,
"side": "SELL",
"time": "2026-09-17T20:31:19Z",
"usdc": 5874120
}
],
"pnl": 3810183,
"profile": {
"address": "0x040cf289b2c5ec4db969b62da464f5bc66c81b97",
"name": "LuisaoL",
"profile_created_at": "2026-06-06T17:03:07.5335Z",
"profile_image": "",
"x_username": ""
},
"rank": 13,
"roi": 190.50915,
"volume": 7874120
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 5000000,
"side": "BUY",
"time": "2026-09-17T18:44:09Z",
"usdc": 1500000
}
],
"pnl": 3500000,
"profile": {
"address": "0xfe787d2da716d60e8acff57fb87eb13cd4d10319",
"name": "ferrariChampions2026",
"profile_created_at": "2026-03-25T18:19:26.033805Z",
"profile_image": "",
"x_username": ""
},
"rank": 14,
"roi": 233.33333333333334,
"volume": 1500000
},
{
"orders": [
{
"fee": 102950,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 10000000,
"side": "BUY",
"time": "2026-09-17T19:35:13Z",
"usdc": 7100000
}
],
"pnl": 2797050,
"profile": {
"address": "0x4afd6fd6b94470bb5512bede17ad0e1cffd1d57b",
"name": "ethan354",
"profile_created_at": "2026-03-10T08:05:11.545731Z",
"profile_image": "",
"x_username": ""
},
"rank": 15,
"roi": 39.39507042253521,
"volume": 7100000
},
{
"orders": [
{
"fee": 56500,
"is_taker": true,
"outcome": "Rafael Tosetto",
"shares": 7062500,
"side": "BUY",
"time": "2026-09-17T18:14:00Z",
"usdc": 5650000
},
{
"fee": 122820,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 11483871,
"side": "BUY",
"time": "2026-09-17T18:27:22Z",
"usdc": 3560000
}
],
"pnl": 2094551,
"profile": {
"address": "0xbfd770b7ff07fb2ece41b0e7c593db65a84cf0bf",
"name": "0xbfD770B7ff0",
"profile_created_at": "2025-10-30T07:03:56.293601Z",
"profile_image": "",
"x_username": ""
},
"rank": 16,
"roi": 29.834248398931948,
"volume": 9210000
},
{
"orders": [
{
"fee": 104080,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 10110000,
"side": "BUY",
"time": "2026-09-17T19:34:54Z",
"usdc": 7178100
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 10110000,
"side": "SELL",
"time": "2026-09-17T19:37:21Z",
"usdc": 7380300
},
{
"fee": 276560,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 29500000,
"side": "BUY",
"time": "2026-09-17T19:38:01Z",
"usdc": 22125000
},
{
"fee": 94680,
"is_taker": true,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 10100000,
"side": "BUY",
"time": "2026-09-17T19:40:25Z",
"usdc": 7575000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 10100000,
"side": "SELL",
"time": "2026-09-17T19:43:46Z",
"usdc": 7777000
},
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 29500000,
"side": "SELL",
"time": "2026-09-17T19:43:46Z",
"usdc": 23305000
}
],
"pnl": 1108880,
"profile": {
"address": "0x72bc9c9d09dda1095030730e7bc93b86f07bb24e",
"name": "therealdeal2",
"profile_created_at": "2025-06-04T11:09:36.949468Z",
"profile_image": "",
"x_username": ""
},
"rank": 17,
"roi": 3.006879421662179,
"volume": 75340400
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 100000000,
"side": "BUY",
"time": "2026-09-17T20:18:45Z",
"usdc": 99000000
}
],
"pnl": 1000000,
"profile": {
"address": "0x1d7e95e52b59a5339654a5eac337ce84bfab3fd4",
"name": "areyoukiddingme",
"profile_created_at": "2026-06-10T11:50:52.310022Z",
"profile_image": "",
"x_username": ""
},
"rank": 18,
"roi": 1.0101010101010102,
"volume": 99000000
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 10000000,
"side": "BUY",
"time": "2026-09-17T20:19:10Z",
"usdc": 9320000
}
],
"pnl": 680000,
"profile": {
"address": "0xe28db285fa8acdf73eb9d184627a1924bc7d9c81",
"name": "asdfsadfasdf1",
"profile_created_at": "2026-05-20T13:55:44.516577Z",
"profile_image": "",
"x_username": ""
},
"rank": 19,
"roi": 7.296137339055794,
"volume": 9320000
},
{
"orders": [
{
"fee": 0,
"is_taker": false,
"outcome": "Livas Eduardo De Carvalho Damazio",
"shares": 10000000,
"side": "BUY",
"time": "2026-09-17T20:19:10Z",
"usdc": 9320000
}
],
"pnl": 680000,
"profile": {
"address": "0x6c21ba8e90183039779f41f9443543a3c2fdbe9e",
"name": "ddlll1",
"profile_created_at": "2026-06-29T09:29:45.603956Z",
"profile_image": "",
"x_username": ""
},
"rank": 20,
"roi": 7.296137339055794,
"volume": 9320000
}
],
"total_fees": 32367810,
"total_pnl_distributed": 1202843059,
"total_traders": 43,
"total_volume": 4458764089,
"total_winners": 23
}响应体字段
| 字段 | 类型 | 说明 |
|---|---|---|
market | object | - |
├─condition_id | string | 0x-prefixed 66-character CTF condition identifier |
├─created_at | string | Timestamp when market was indexed in database (RFC 3339 UTC) |
├─description | string | Extended details and market resolution criteria |
├─end_date | string | Estimated resolution date or scheduled closing time (RFC 3339 UTC) |
├─event_slug | string | URL slug of the parent event containing this market |
├─fee_schedule | object | Detailed fee schedule JSON specification |
├─fee_type | string | Fee model classification (e.g. "dynamic", "fixed") |
├─fees_enabled | boolean | Whether trading fees are activated on this market |
├─group_item_threshold | integer | Threshold for numerical interval outcomes if applicable |
├─group_item_title | string | Sub-category item title within a grouped multi-market event |
├─icon | string | Market thumbnail image URL |
├─id | integer | Unique numeric prediction market identifier |
├─neg_risk | boolean | True if market operates under multi-outcome negative risk adapter |
├─outcomes | string[] | Raw JSON array of outcome display names, e.g. ["Yes", "No"] |
├─question | string | Full title question describing the market condition |
├─resolution_source | string | Source URL or oracle specification for resolution |
├─resolved_at | string | Timestamp when the market officially settled (RFC 3339 UTC), or null if active |
├─result | integer | Resolution outcome (-2: unresolved, -1: void/invalid, 0-100: payout percentage for Outcome 0, e.g. 100 = Outcome 0 won, 0 = Outcome 1 won, 50 = 50/50 split) |
├─series_slug | string | URL slug of the recurring sports league or tournament series |
├─slug | string | URL-friendly slug identifying the market on Polymarket |
├─sports_market_type | string | Sports market classification type if applicable |
├─start_date | string | Timestamp when trading began (RFC 3339 UTC) |
├─tags_slug | string[] | Raw JSON array of topic tag URL slugs |
├─token_ids | string[] | Array of 2 ERC-1155 token IDs corresponding to outcomes |
top_earners | array of objects | Ranked list of top 20 profitable traders in this market |
├─orders | array of objects | Executed fill orders for this earner (included when include_orders=true) |
├─fee | integer | Protocol trading fee deducted in micro-USD (6 decimals) |
├─is_taker | boolean | True if executed against resting book liquidity as a taker |
├─outcome | string | Prediction outcome label (e.g. "Yes", "No") |
├─shares | integer | Filled outcome token shares (6 decimals) |
├─side | string | Order execution side: "BUY" or "SELL" |
├─time | string | ISO 8601 UTC timestamp of order fill execution |
├─usdc | integer | Total collateral USDC transferred (6 decimals micro-USD) |
├─pnl | integer | Realized net profit and loss in micro-USD (6 decimals, e.g. 1000000 = 1 USD) |
├─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 |
├─rank | integer | Rank position among top earners in this market (1-based) |
├─roi | number | Return on investment percentage (e.g. 25.5 for 25.5%) |
├─volume | integer | Total traded volume in micro-USD (6 decimals) |
total_fees | integer | Total protocol and liquidity fees collected in micro-USD (6 decimals) |
total_pnl_distributed | integer | Total positive realized PnL distributed to winners in micro-USD (6 decimals) |
total_traders | integer | Total count of distinct wallet addresses that traded this market |
total_volume | integer | Cumulative trading volume across all participants in micro-USD (6 decimals) |
total_winners | integer | Total number of distinct traders with positive realized PnL |
cURL 示例
在终端中直接复制并运行此命令测试该接口。
cURL: GET /v2/markets/{id}
bash
curl -X GET "https://api.polyedge.dev/v2/markets/4629816?include_orders=true" \
-H "X-PolyEdge-Key: Your-PolyEdge-ApiKey"