{ "item": [ { "name": "v1", "description": "", "item": [ { "name": "health", "description": "", "item": [ { "id": "6c75ec61-6686-409d-a51c-69594cbbaff1", "name": "Health check", "request": { "name": "Health check", "description": {}, "url": { "path": [ "v1", "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "63b717d9-a5ab-485c-b8d1-7fdbd279f74b", "name": "Successful envelope response", "originalRequest": { "url": { "path": [ "v1", "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-API-Version", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Money-Format", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-PII-Redacted", "value": "" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "markets", "description": "", "item": [ { "id": "908477a9-9ea3-45fd-b0bf-c7e3fb6454f1", "name": "List active markets", "request": { "name": "List active markets", "description": {}, "url": { "path": [ "v1", "markets" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "category", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of fast,normal,creator)", "type": "text/plain" }, "key": "market_type", "value": "creator" }, { "disabled": false, "description": { "content": " (This can only be one of active,locked,settling)", "type": "text/plain" }, "key": "status", "value": "locked" }, { "disabled": false, "description": { "content": "Opaque pagination cursor (from previous response `meta.next_cursor`)", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "Max rows to return (1-500, default 50)", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "05d40a01-f5b1-49bb-84e1-d3497c724e6f", "name": "Paginated market list", "originalRequest": { "url": { "path": [ "v1", "markets" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "category", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of fast,normal,creator)", "type": "text/plain" }, "key": "market_type", "value": "creator" }, { "disabled": false, "description": { "content": " (This can only be one of active,locked,settling)", "type": "text/plain" }, "key": "status", "value": "locked" }, { "disabled": false, "description": { "content": "Opaque pagination cursor (from previous response `meta.next_cursor`)", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "Max rows to return (1-500, default 50)", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"market_id\": \"\",\n \"template_id\": \"\",\n \"title\": \"\",\n \"status\": \"scheduled\",\n \"outcomes\": [\n {\n \"id\": \"\",\n \"label\": \"\",\n \"price\": \"474223\",\n \"volume_24h\": \"9373922725\"\n },\n {\n \"id\": \"\",\n \"label\": \"\",\n \"price\": \"90882545391\",\n \"volume_24h\": \"17\"\n }\n ],\n \"template_version\": \"\",\n \"subtitle\": \"\",\n \"description\": \"\",\n \"image_url\": \"\",\n \"category\": \"\",\n \"market_type\": \"creator\",\n \"outcome_schema\": \"multi\",\n \"opens_at_ms\": \"\",\n \"closes_at_ms\": \"\",\n \"settles_at_ms\": \"\",\n \"total_volume\": \"9538\",\n \"open_interest\": \"-55687\",\n \"creator_address\": \"\",\n \"chain_data\": {}\n },\n {\n \"market_id\": \"\",\n \"template_id\": \"\",\n \"title\": \"\",\n \"status\": \"active\",\n \"outcomes\": [\n {\n \"id\": \"\",\n \"label\": \"\",\n \"price\": \"631322220\",\n \"volume_24h\": \"-721\"\n },\n {\n \"id\": \"\",\n \"label\": \"\",\n \"price\": \"-874.41248512313545\",\n \"volume_24h\": \"-6097\"\n }\n ],\n \"template_version\": \"\",\n \"subtitle\": \"\",\n \"description\": \"\",\n \"image_url\": \"\",\n \"category\": \"\",\n \"market_type\": \"normal\",\n \"outcome_schema\": \"binary\",\n \"opens_at_ms\": \"\",\n \"closes_at_ms\": \"\",\n \"settles_at_ms\": \"\",\n \"total_volume\": \"4954.37\",\n \"open_interest\": \"80716029.4309590116696928\",\n \"creator_address\": \"\",\n \"chain_data\": {}\n }\n ],\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7b5381ba-d3e6-4e88-b925-da4f4577dad2", "name": "Create market from template (creator flow)", "request": { "name": "Create market from template (creator flow)", "description": { "content": "**Deterministic**: `market_id = m_ + sha256(template_id + params + creator)[0:16]`.\nIdempotent — repeat POST returns existing market. Requires creator deposit\n(per template's `min_creator_deposit`, drawn from account's `balance_free`).\nBlocked if `risk_settings.read_only_mode = 1` → 503.\n", "type": "text/plain" }, "url": { "path": [ "v1", "markets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"template_id\": \"\",\n \"params\": {},\n \"creator_metadata\": {\n \"display_title\": \"\",\n \"display_image_url\": \"\"\n },\n \"idempotency_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "6fe4154e-f339-4796-ab64-fa22f396bf30", "name": "Market created (or existing returned if idempotent)", "originalRequest": { "url": { "path": [ "v1", "markets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"template_id\": \"\",\n \"params\": {},\n \"creator_metadata\": {\n \"display_title\": \"\",\n \"display_image_url\": \"\"\n },\n \"idempotency_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"market\": {\n \"market_id\": \"\",\n \"template_id\": \"\",\n \"title\": \"\",\n \"status\": \"resolved\",\n \"outcomes\": [\n {\n \"id\": \"\",\n \"label\": \"\",\n \"price\": \"-2487542\",\n \"volume_24h\": \"33314\"\n },\n {\n \"id\": \"\",\n \"label\": \"\",\n \"price\": \"-4762130\",\n \"volume_24h\": \"-7940567161.97444823911609367\"\n }\n ],\n \"template_version\": \"\",\n \"subtitle\": \"\",\n \"description\": \"\",\n \"image_url\": \"\",\n \"category\": \"\",\n \"market_type\": \"fast\",\n \"outcome_schema\": \"binary\",\n \"opens_at_ms\": \"\",\n \"closes_at_ms\": \"\",\n \"settles_at_ms\": \"\",\n \"total_volume\": \"35\",\n \"open_interest\": \"02\",\n \"creator_address\": \"\",\n \"chain_data\": {}\n },\n \"template\": {\n \"id\": \"\",\n \"name\": \"\",\n \"category\": \"\",\n \"market_type\": \"creator\",\n \"params_schema\": {},\n \"version\": \"\",\n \"outcome_schema\": \"multi\",\n \"min_bet\": \"35638\",\n \"max_bet\": \"6114492571.78377546\",\n \"fee_schedule\": {\n \"maker_bps\": \"\",\n \"taker_bps\": \"\",\n \"settle_bps\": \"\"\n },\n \"display_defaults\": {\n \"title_template\": \"\",\n \"image_url_pattern\": \"\"\n },\n \"round_config\": {\n \"duration_sec\": \"\",\n \"lock_offset_ms\": \"\"\n },\n \"status\": \"draft\"\n }\n },\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c70e905-4608-4f63-8afc-bb9ab12e7976", "name": "Bad request (validation error)", "originalRequest": { "url": { "path": [ "v1", "markets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"template_id\": \"\",\n \"params\": {},\n \"creator_metadata\": {\n \"display_title\": \"\",\n \"display_image_url\": \"\"\n },\n \"idempotency_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62ae8f2d-4a26-4ffd-bcfb-2ae5915bafcd", "name": "Unauthorized (missing/invalid credential)", "originalRequest": { "url": { "path": [ "v1", "markets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"template_id\": \"\",\n \"params\": {},\n \"creator_metadata\": {\n \"display_title\": \"\",\n \"display_image_url\": \"\"\n },\n \"idempotency_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0ec9bf0c-e0c6-44bd-baf6-d32cb63c4b65", "name": "Service unavailable (e.g., read_only_mode)", "originalRequest": { "url": { "path": [ "v1", "markets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"template_id\": \"\",\n \"params\": {},\n \"creator_metadata\": {\n \"display_title\": \"\",\n \"display_image_url\": \"\"\n },\n \"idempotency_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "templates", "description": "", "item": [ { "id": "024a7aa7-720f-446f-afe6-b9f407a946f7", "name": "List active market templates", "request": { "name": "List active market templates", "description": { "content": "Templates define market shape (outcomes, fees, oracle, display).", "type": "text/plain" }, "url": { "path": [ "v1", "markets", "templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "category", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of fast,normal,creator)", "type": "text/plain" }, "key": "market_type", "value": "creator" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "3958729f-9e65-4f34-82b5-c35138a7d956", "name": "Template list", "originalRequest": { "url": { "path": [ "v1", "markets", "templates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "category", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of fast,normal,creator)", "type": "text/plain" }, "key": "market_type", "value": "creator" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"category\": \"\",\n \"market_type\": \"creator\",\n \"params_schema\": {},\n \"version\": \"\",\n \"outcome_schema\": \"scalar\",\n \"min_bet\": \"-076244438.290399\",\n \"max_bet\": \"8070120.9999398974\",\n \"fee_schedule\": {\n \"maker_bps\": \"\",\n \"taker_bps\": \"\",\n \"settle_bps\": \"\"\n },\n \"display_defaults\": {\n \"title_template\": \"\",\n \"image_url_pattern\": \"\"\n },\n \"round_config\": {\n \"duration_sec\": \"\",\n \"lock_offset_ms\": \"\"\n },\n \"status\": \"deprecated\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"category\": \"\",\n \"market_type\": \"normal\",\n \"params_schema\": {},\n \"version\": \"\",\n \"outcome_schema\": \"binary\",\n \"min_bet\": \"-7\",\n \"max_bet\": \"7747175038.80601040037223453\",\n \"fee_schedule\": {\n \"maker_bps\": \"\",\n \"taker_bps\": \"\",\n \"settle_bps\": \"\"\n },\n \"display_defaults\": {\n \"title_template\": \"\",\n \"image_url_pattern\": \"\"\n },\n \"round_config\": {\n \"duration_sec\": \"\",\n \"lock_offset_ms\": \"\"\n },\n \"status\": \"deprecated\"\n }\n ],\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "{market_id}", "description": "", "item": [ { "id": "7dc7bdd5-45bd-4187-a2d3-b4422ffce5ef", "name": "Get single market detail", "request": { "name": "Get single market detail", "description": {}, "url": { "path": [ "v1", "markets", ":market_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "m_8ff28db4f76a0d", "key": "market_id", "disabled": false, "description": { "content": "(Required) Deterministic market ID `m_`", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "e9e191eb-ce5e-47ae-818b-b22fc1bdee94", "name": "Market detail", "originalRequest": { "url": { "path": [ "v1", "markets", ":market_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Deterministic market ID `m_`", "type": "text/plain" }, "type": "any", "value": "m_8ff28db4f76a0d", "key": "market_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"market_id\": \"\",\n \"template_id\": \"\",\n \"title\": \"\",\n \"status\": \"scheduled\",\n \"outcomes\": [\n {\n \"id\": \"\",\n \"label\": \"\",\n \"price\": \"-92.9027624505\",\n \"volume_24h\": \"-96\"\n },\n {\n \"id\": \"\",\n \"label\": \"\",\n \"price\": \"-64.7676\",\n \"volume_24h\": \"-99158862.154146951\"\n }\n ],\n \"template_version\": \"\",\n \"subtitle\": \"\",\n \"description\": \"\",\n \"image_url\": \"\",\n \"category\": \"\",\n \"market_type\": \"normal\",\n \"outcome_schema\": \"multi\",\n \"opens_at_ms\": \"\",\n \"closes_at_ms\": \"\",\n \"settles_at_ms\": \"\",\n \"total_volume\": \"4550436\",\n \"open_interest\": \"-7.755423972\",\n \"creator_address\": \"\",\n \"chain_data\": {}\n },\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31a75429-700e-47ad-beff-053c1ed00dcf", "name": "Not found", "originalRequest": { "url": { "path": [ "v1", "markets", ":market_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Deterministic market ID `m_`", "type": "text/plain" }, "type": "any", "value": "m_8ff28db4f76a0d", "key": "market_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "candles", "description": "", "item": [ { "name": "{market_id}", "description": "", "item": [ { "id": "61c6d4b0-b7b3-4c78-92e5-74c94590ae27", "name": "OHLCV candles for market's outcome price history", "request": { "name": "OHLCV candles for market's outcome price history", "description": {}, "url": { "path": [ "v1", "candles", ":market_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "outcome_id", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of 1m,5m,15m,30m,1h,4h,1d)", "type": "text/plain" }, "key": "interval", "value": "1m" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from_ms", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to_ms", "value": "" }, { "disabled": false, "description": { "content": "Max rows to return (1-500, default 50)", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [ { "type": "any", "value": "m_8ff28db4f76a0d", "key": "market_id", "disabled": false, "description": { "content": "(Required) Deterministic market ID `m_`", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ae93209f-00c5-4526-836e-9994ba03d290", "name": "Candles", "originalRequest": { "url": { "path": [ "v1", "candles", ":market_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "outcome_id", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of 1m,5m,15m,30m,1h,4h,1d)", "type": "text/plain" }, "key": "interval", "value": "1m" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "from_ms", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "to_ms", "value": "" }, { "disabled": false, "description": { "content": "Max rows to return (1-500, default 50)", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Deterministic market ID `m_`", "type": "text/plain" }, "type": "any", "value": "m_8ff28db4f76a0d", "key": "market_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"ts_ms\": \"\",\n \"open\": \"-4080013\",\n \"high\": \"-422.166913671184\",\n \"low\": \"13381495772\",\n \"close\": \"4357.57140042232001788\",\n \"volume\": \"60894\"\n },\n {\n \"ts_ms\": \"\",\n \"open\": \"7164484322\",\n \"high\": \"30039832339.24438381318520386\",\n \"low\": \"5026781261.614\",\n \"close\": \"-25924534894.1\",\n \"volume\": \"8267179\"\n }\n ],\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "orderbook", "description": "", "item": [ { "name": "{market_id}", "description": "", "item": [ { "id": "45d370f2-ea84-401b-942a-a8d511f39111", "name": "Top-of-book depth", "request": { "name": "Top-of-book depth", "description": {}, "url": { "path": [ "v1", "orderbook", ":market_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "outcome_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "depth", "value": "20" } ], "variable": [ { "type": "any", "value": "m_8ff28db4f76a0d", "key": "market_id", "disabled": false, "description": { "content": "(Required) Deterministic market ID `m_`", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "7caa262a-cece-451b-bdda-0cd1ed5cfeba", "name": "Orderbook snapshot (subscribe to WS for live updates)", "originalRequest": { "url": { "path": [ "v1", "orderbook", ":market_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "outcome_id", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "depth", "value": "20" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Deterministic market ID `m_`", "type": "text/plain" }, "type": "any", "value": "m_8ff28db4f76a0d", "key": "market_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"bids\": [\n [\n \"-33918\",\n \"9.62143947374\"\n ],\n [\n \"34173304834.898295\",\n \"-02223295\"\n ]\n ],\n \"asks\": [\n [\n \"3241.29669\",\n \"-720.664377771645\"\n ],\n [\n \"572537\",\n \"-67515\"\n ]\n ],\n \"ts_ms\": \"\"\n },\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "trades", "description": "", "item": [ { "name": "{market_id}", "description": "", "item": [ { "id": "5bb941e2-de79-43dd-8ab2-e1a043b705f4", "name": "Recent trades (public tape)", "request": { "name": "Recent trades (public tape)", "description": {}, "url": { "path": [ "v1", "trades", ":market_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "outcome_id", "value": "" }, { "disabled": false, "description": { "content": "Opaque pagination cursor (from previous response `meta.next_cursor`)", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "Max rows to return (1-500, default 50)", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [ { "type": "any", "value": "m_8ff28db4f76a0d", "key": "market_id", "disabled": false, "description": { "content": "(Required) Deterministic market ID `m_`", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "b7d5b668-041a-4d1a-92cb-15e0ea292a9f", "name": "Trades", "originalRequest": { "url": { "path": [ "v1", "trades", ":market_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "outcome_id", "value": "" }, { "disabled": false, "description": { "content": "Opaque pagination cursor (from previous response `meta.next_cursor`)", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "Max rows to return (1-500, default 50)", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Deterministic market ID `m_`", "type": "text/plain" }, "type": "any", "value": "m_8ff28db4f76a0d", "key": "market_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"trade_id\": \"\",\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"side\": \"sell\",\n \"price\": \"-40\",\n \"size\": \"4635180764.5458797788989\",\n \"ts_ms\": \"\"\n },\n {\n \"trade_id\": \"\",\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"side\": \"sell\",\n \"price\": \"-6864005.2212606\",\n \"size\": \"-4071982\",\n \"ts_ms\": \"\"\n }\n ],\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "account", "description": "", "item": [ { "id": "a30ca2f4-4797-43e3-ab7b-f6d9fe0137da", "name": "Get authenticated account", "request": { "name": "Get authenticated account", "description": {}, "url": { "path": [ "v1", "account" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1f73b061-48f9-4fcb-9421-b4ff16f57a88", "name": "Account snapshot", "originalRequest": { "url": { "path": [ "v1", "account" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"account_id\": \"\",\n \"wallet_address\": \"\",\n \"balance_free\": \"-759039.7643603914\",\n \"balance_reserved\": \"-26095498\",\n \"asset\": \"USDT\",\n \"mode\": \"live\",\n \"created_at_ms\": \"\"\n },\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5245a3d5-ecbb-4fed-853f-11c9ec215345", "name": "Unauthorized (missing/invalid credential)", "originalRequest": { "url": { "path": [ "v1", "account" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "positions", "description": "", "item": [ { "id": "566bec70-2db5-4c84-81b4-beb00b972209", "name": "List open positions", "request": { "name": "List open positions", "description": {}, "url": { "path": [ "v1", "account", "positions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ff7fa2ef-cb45-4950-8958-72441f92c928", "name": "Positions", "originalRequest": { "url": { "path": [ "v1", "account", "positions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"size\": \"2516.1456\",\n \"avg_price\": \"-8794.6938683\",\n \"unrealized_pnl\": \"235577\",\n \"realized_pnl\": \"7738546543.621445823\"\n },\n {\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"size\": \"4.12093312699120\",\n \"avg_price\": \"-13786841994\",\n \"unrealized_pnl\": \"-3.08553\",\n \"realized_pnl\": \"44\"\n }\n ],\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "orders", "description": "", "item": [ { "id": "467f95fb-c5a8-4180-9c65-5186a382d811", "name": "List orders (active + recent)", "request": { "name": "List orders (active + recent)", "description": {}, "url": { "path": [ "v1", "account", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of pending,filled,cancelled,all)", "type": "text/plain" }, "key": "status", "value": "cancelled" }, { "disabled": false, "description": { "content": "Opaque pagination cursor (from previous response `meta.next_cursor`)", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "Max rows to return (1-500, default 50)", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "e55dad66-ffec-4c5e-9ddb-070ab71b88a4", "name": "Orders", "originalRequest": { "url": { "path": [ "v1", "account", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of pending,filled,cancelled,all)", "type": "text/plain" }, "key": "status", "value": "cancelled" }, { "disabled": false, "description": { "content": "Opaque pagination cursor (from previous response `meta.next_cursor`)", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "Max rows to return (1-500, default 50)", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"side\": \"sell\",\n \"order_type\": \"limit\",\n \"size\": \"89\",\n \"order_id\": \"\",\n \"price\": \"8424\",\n \"status\": \"pending\",\n \"filled_size\": \"84520.765462857\",\n \"avg_fill_price\": \"088\",\n \"created_at_ms\": \"\",\n \"client_order_id\": \"\"\n },\n {\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"side\": \"buy\",\n \"order_type\": \"market\",\n \"size\": \"-185638828.9164285577493294\",\n \"order_id\": \"\",\n \"price\": \"-39\",\n \"status\": \"cancelled\",\n \"filled_size\": \"7\",\n \"avg_fill_price\": \"-248415\",\n \"created_at_ms\": \"\",\n \"client_order_id\": \"\"\n }\n ],\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "trades", "description": "", "item": [ { "id": "ac9e3cc2-9b94-41f0-9cd6-6a74d2e688a3", "name": "List own trade fills", "request": { "name": "List own trade fills", "description": {}, "url": { "path": [ "v1", "account", "trades" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque pagination cursor (from previous response `meta.next_cursor`)", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "Max rows to return (1-500, default 50)", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "3ae695fd-43e6-46cd-9d1b-f8d4472ab622", "name": "Own trades", "originalRequest": { "url": { "path": [ "v1", "account", "trades" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Opaque pagination cursor (from previous response `meta.next_cursor`)", "type": "text/plain" }, "key": "cursor", "value": "" }, { "disabled": false, "description": { "content": "Max rows to return (1-500, default 50)", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"trade_id\": \"\",\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"side\": \"sell\",\n \"price\": \"-40\",\n \"size\": \"4635180764.5458797788989\",\n \"ts_ms\": \"\"\n },\n {\n \"trade_id\": \"\",\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"side\": \"sell\",\n \"price\": \"-6864005.2212606\",\n \"size\": \"-4071982\",\n \"ts_ms\": \"\"\n }\n ],\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "orders", "description": "", "item": [ { "id": "14d84ce8-241b-48b9-9e43-04ad26c8a221", "name": "Place order", "request": { "name": "Place order", "description": { "content": "Engine-agnostic — server routes to AMM or CLOB per market. If you need\nto know venue, check `meta.fill_venue` in response.\n", "type": "text/plain" }, "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"side\": \"buy\",\n \"order_type\": \"market\",\n \"size\": \"92244402644.2458557064420\",\n \"price\": \"1613551.88980861678\",\n \"filled_size\": \"-80\",\n \"avg_fill_price\": \"8917778\",\n \"client_order_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c097aa3a-7f87-49f5-a4b7-9f71674138e8", "name": "Order accepted (may be immediately filled)", "originalRequest": { "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"side\": \"buy\",\n \"order_type\": \"market\",\n \"size\": \"92244402644.2458557064420\",\n \"price\": \"1613551.88980861678\",\n \"filled_size\": \"-80\",\n \"avg_fill_price\": \"8917778\",\n \"client_order_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"side\": \"buy\",\n \"order_type\": \"market\",\n \"size\": \"783053222.42\",\n \"order_id\": \"\",\n \"price\": \"-5628305480\",\n \"status\": \"partially_filled\",\n \"filled_size\": \"424171629.3760278589912\",\n \"avg_fill_price\": \"-4414626\",\n \"created_at_ms\": \"\",\n \"client_order_id\": \"\"\n },\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\",\n \"fill_venue\": \"amm\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8508c358-4c7c-4d2f-8c02-0ba3bb1ca834", "name": "Bad request (validation error)", "originalRequest": { "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"side\": \"buy\",\n \"order_type\": \"market\",\n \"size\": \"92244402644.2458557064420\",\n \"price\": \"1613551.88980861678\",\n \"filled_size\": \"-80\",\n \"avg_fill_price\": \"8917778\",\n \"client_order_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d6e1c8d-8d0e-47bd-931c-07acf05750a1", "name": "Service unavailable (e.g., read_only_mode)", "originalRequest": { "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"market_id\": \"\",\n \"outcome_id\": \"\",\n \"side\": \"buy\",\n \"order_type\": \"market\",\n \"size\": \"92244402644.2458557064420\",\n \"price\": \"1613551.88980861678\",\n \"filled_size\": \"-80\",\n \"avg_fill_price\": \"8917778\",\n \"client_order_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{order_id}", "description": "", "item": [ { "id": "673deeda-9680-4fdd-96a7-ccf2d9932d03", "name": "Cancel order", "request": { "name": "Cancel order", "description": {}, "url": { "path": [ "v1", "orders", ":order_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "order_id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "a0299aa9-df27-4bbe-937e-9e5091d5f13e", "name": "Successful envelope response", "originalRequest": { "url": { "path": [ "v1", "orders", ":order_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-API-Version", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Money-Format", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-PII-Redacted", "value": "" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d9d758e2-3dd2-401f-a5da-cda1c30b2db3", "name": "Not found", "originalRequest": { "url": { "path": [ "v1", "orders", ":order_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "order_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "keys", "description": "", "item": [ { "id": "118847b3-bfc8-4644-87aa-8b044baf5917", "name": "Mint new API key", "request": { "name": "Mint new API key", "description": { "content": "Returns key + secret + passphrase ONCE. Store securely — cannot be\nretrieved again. On sandbox, prefix is `sk_test_*`; on prod, `sk_live_*`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"label\": \"\",\n \"permissions\": [\n \"read\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c3772a7d-200c-4163-a762-3bf59e1fe96c", "name": "New key material (SHOW ONCE — cannot re-fetch)", "originalRequest": { "url": { "path": [ "v1", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"label\": \"\",\n \"permissions\": [\n \"read\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"key_id\": \"\",\n \"secret\": \"\",\n \"passphrase\": \"\",\n \"permissions\": [\n \"\",\n \"\"\n ],\n \"created_at_ms\": \"\"\n },\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "397eb06d-17eb-4d3b-96c7-fd64c2393e47", "name": "List own API keys (metadata only, no secrets)", "request": { "name": "List own API keys (metadata only, no secrets)", "description": {}, "url": { "path": [ "v1", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c972c4f4-540c-448a-81dc-f45672ee813c", "name": "Key list", "originalRequest": { "url": { "path": [ "v1", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{key_id}", "description": "", "item": [ { "id": "4bd4b7e5-5952-4112-a9a4-b3740df8641d", "name": "Revoke API key", "request": { "name": "Revoke API key", "description": {}, "url": { "path": [ "v1", "keys", ":key_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "key_id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "52b8b1ff-cbe7-4fdc-9381-37f4348e2f64", "name": "Successful envelope response", "originalRequest": { "url": { "path": [ "v1", "keys", ":key_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "key_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-API-Version", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Money-Format", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-PII-Redacted", "value": "" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "950ecb4c-9a73-4b46-8d92-9ee8cd72fc23", "name": "Not found", "originalRequest": { "url": { "path": [ "v1", "keys", ":key_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "key_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "sandbox", "description": "", "item": [ { "name": "faucet", "description": "", "item": [ { "id": "495fc491-6f39-4205-8800-0f615c928372", "name": "(Sandbox only) Mint fake USDT for testing", "request": { "name": "(Sandbox only) Mint fake USDT for testing", "description": { "content": "Delivers 10,000 test USDT to authenticated account. Max 1 call per hour\nper key. Only works on `sandbox.predictasiax.com` — 404 on prod.\n", "type": "text/plain" }, "url": { "path": [ "v1", "sandbox", "faucet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "29a6a0b1-eb06-4e41-a6e9-1513ac1bdc1b", "name": "Successful envelope response", "originalRequest": { "url": { "path": [ "v1", "sandbox", "faucet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-API-Version", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Money-Format", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-PII-Redacted", "value": "" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c314442e-6079-46fd-9f43-a6caf047485f", "name": "Not sandbox environment", "originalRequest": { "url": { "path": [ "v1", "sandbox", "faucet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8905edb1-8dd9-4caf-a828-ecd3c3b3cdfd", "name": "Rate limited", "originalRequest": { "url": { "path": [ "v1", "sandbox", "faucet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Retry-After", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" } ], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "reset", "description": "", "item": [ { "id": "37713653-9b08-4642-87fa-396db3c72d60", "name": "(Sandbox only) Wipe partner state — positions, orders, balance", "request": { "name": "(Sandbox only) Wipe partner state — positions, orders, balance", "description": { "content": "Resets account to fresh state (0 balance, 0 positions, cancels all orders).\nIdempotent. Only works on sandbox.\n", "type": "text/plain" }, "url": { "path": [ "v1", "sandbox", "reset" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "34ecf60d-1411-457d-a477-c1eb2127dca4", "name": "Successful envelope response", "originalRequest": { "url": { "path": [ "v1", "sandbox", "reset" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-API-Version", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Money-Format", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-PII-Redacted", "value": "" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "573ecf47-b932-4bfc-9248-2287c802fe75", "name": "Not sandbox environment", "originalRequest": { "url": { "path": [ "v1", "sandbox", "reset" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "mock-oracle", "description": "", "item": [ { "id": "235ef04b-5096-4116-a8d7-fd1cdfd6ba30", "name": "(Sandbox only) Force settlement of test market", "request": { "name": "(Sandbox only) Force settlement of test market", "description": { "content": "Set outcome for a sandbox market to test settlement flow without\nwaiting for real oracle. Only works on markets created in sandbox with\n`template.oracle_config.source = sandbox_mock`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "sandbox", "mock-oracle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"market_id\": \"\",\n \"winning_outcome_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "428791c0-cce8-4b32-a34e-63220279c9be", "name": "Successful envelope response", "originalRequest": { "url": { "path": [ "v1", "sandbox", "mock-oracle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"market_id\": \"\",\n \"winning_outcome_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-API-Version", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Money-Format", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-PII-Redacted", "value": "" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68e2bed5-dee9-4341-8cc2-73c712d72197", "name": "Bad request (validation error)", "originalRequest": { "url": { "path": [ "v1", "sandbox", "mock-oracle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"market_id\": \"\",\n \"winning_outcome_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": \"\",\n \"meta\": {\n \"request_id\": \"\",\n \"server_ts_ms\": \"\",\n \"next_cursor\": \"\",\n \"page_size\": \"\",\n \"total_count\": \"\"\n },\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01dfbadd-6dbb-4b49-a5a6-b798f27c3748", "name": "Market not sandbox-oracle-eligible", "originalRequest": { "url": { "path": [ "v1", "sandbox", "mock-oracle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"market_id\": \"\",\n \"winning_outcome_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "type": "any", "value": "{{bearerToken}}", "key": "token" } ] }, "event": [], "variable": [ { "key": "baseUrl", "value": "https://predictasiax.com/api" } ], "info": { "_postman_id": "6c68eb80-2a2d-4ebe-a426-7496ac526937", "name": "PredictAsiaX Trader Track API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "PAX Trader Track = 4-surface REST API for wallets, aggregators, partners, and end-user apps.\n\n- **Discovery** (`/v1/markets`, `/v1/markets/templates`) — read-only market catalog\n- **Market Data** (`/v1/candles`, `/v1/orderbook`, `/v1/trades`) — price + depth + fills\n- **Account** (`/v1/account/*`) — balance, positions, orders, trades (per API key owner)\n- **Trading** (`/v1/orders`, `POST /v1/markets`) — order entry + creator markets\n\nOperator Track (RGS + Seamless Wallet for iGaming operators) is a separate spec: see\n`docs.predictasiax.com/operator`. FIX 4.4 gateway for institutional order entry: see\n`docs.predictasiax.com/fix`.\n\n### Design principles (from Polymarket + Kalshi + Vertex research)\n- Engine-agnostic: response never leaks AMM vs CLOB (`meta.fill_venue` optional debug)\n- Deterministic IDs: `m_` for markets (idempotent create)\n- Web3 privacy first: email/phone/IP stripped from external responses by default\n- Envelope: `{ok, data, meta}` on every canonical response\n- snake_case everywhere; money as decimal string (6 decimals for USDT, 8 for BTC)\n- `*_at_ms` sibling for every `*_at` timestamp (ms epoch, easier for clients)\n\n\nContact Support:\n Name: PAX Partners\n Email: partners@predictasiax.com", "type": "text/plain" } } }