# GET /api/v1/predictions > Polymarket and Limitless positions grouped by event, with whether the chain agreed on each. Source: https://docs.getport.app/api/reference/predictions/ ## Example The key is read from `PORT_API_KEY`, so the command never prints it. ```sh curl -s https://getport.app/api/v1/predictions -H "Authorization: Bearer $PORT_API_KEY" ``` ## Response A 200 with the [envelope](https://docs.getport.app/api/#the-envelope) every endpoint answers, and this endpoint's answer in `data`. Amounts and USD figures are strings. What `data` looks like, with sample values: the shape is the schema's, checked when these pages are built, and the figures are made up, not anyone's port. ``` { "positions": [ { "id": "3f6c2a1e-8b7d-4e2f-9a1c-5d4b3e2f1a0c", "walletAddress": "0x8f3c0e7b2a91d4c6f5e3b2a1908d7c6b5a4fc21a", "venue": "Polymarket", "eventLabel": "ETH above $3,000 on 31 December", "eventId": "eth-above-3000-on-december-31", "eventIcon": null, "eventMarketCount": 1, "conditionId": "0x9c4f2e7d1a6b3c8e5f0a9d2b7c4e1f6a3d8b5c2e9f7a4d1b6c3e8f5a2d9b7c4e", "tokenId": "71321045863084981365469390896945813429764131283624592880862542340", "mergeable": false, "redeemable": false, "question": "Will ETH close above $3,000 on 31 December?", "outcomeLabel": "Yes", "outcomeIndex": 0, "imageUrl": null, "status": "open", "closesAt": "2026-12-31T23:59:00.000Z", "resolvedAt": null, "shares": "400", "avgEntryUsd": "0.31", "costUsd": "124.00", "markUsd": "0.38", "valueUsd": "152.00", "unrealisedUsd": "28.00", "realisedUsd": "0.00", "won": null, "claimableUsd": "0.00", "verified": true, "confidence": 1, "url": null, "marketUrl": null } ], "openUsd": "152.00", "openCostUsd": "124.00", "claimableUsd": "0.00", "realisedUsd": "0.00", "unverified": 1, "asOf": "2026-10-06T05:42:10.000Z" } ``` | Field of `data` | Type | Always present | | --------------- | ----------------- | -------------- | | `positions` | `array of object` | yes | | `openUsd` | `string` | yes | | `openCostUsd` | `string` | yes | | `claimableUsd` | `string` | yes | | `realisedUsd` | `string` | yes | | `unverified` | `number` | yes | | `asOf` | `string or null` | yes | The whole schema of `data` As the OpenAPI document at [`https://getport.app/api/v1/openapi.json`](https://getport.app/api/v1/openapi.json) states it. Objects are left open, because a response only ever gains fields. ``` { "type": "object", "properties": { "positions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "walletAddress": { "type": "string" }, "venue": { "type": "string" }, "eventLabel": { "type": [ "string", "null" ] }, "eventId": { "type": [ "string", "null" ] }, "eventIcon": { "type": [ "string", "null" ] }, "eventMarketCount": { "type": "number" }, "conditionId": { "type": "string" }, "tokenId": { "type": "string" }, "mergeable": { "type": "boolean" }, "redeemable": { "type": "boolean" }, "question": { "type": "string" }, "outcomeLabel": { "type": "string" }, "outcomeIndex": { "type": "number" }, "imageUrl": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "open", "suspended", "resolved", "cancelled", "pending" ] }, "closesAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, { "type": "null" } ] }, "resolvedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, { "type": "null" } ] }, "shares": { "type": "string" }, "avgEntryUsd": { "type": "string" }, "costUsd": { "type": "string" }, "markUsd": { "type": [ "string", "null" ] }, "valueUsd": { "type": [ "string", "null" ] }, "unrealisedUsd": { "type": [ "string", "null" ] }, "realisedUsd": { "type": "string" }, "won": { "type": [ "boolean", "null" ] }, "claimableUsd": { "type": [ "string", "null" ] }, "verified": { "type": "boolean" }, "confidence": { "type": "number" }, "url": { "type": [ "string", "null" ] }, "marketUrl": { "type": [ "string", "null" ] } }, "required": [ "id", "walletAddress", "venue", "eventLabel", "eventId", "eventIcon", "eventMarketCount", "conditionId", "tokenId", "mergeable", "redeemable", "question", "outcomeLabel", "outcomeIndex", "imageUrl", "status", "closesAt", "resolvedAt", "shares", "avgEntryUsd", "costUsd", "markUsd", "valueUsd", "unrealisedUsd", "realisedUsd", "won", "claimableUsd", "verified", "confidence", "url" ] } }, "openUsd": { "type": "string" }, "openCostUsd": { "type": "string" }, "claimableUsd": { "type": "string" }, "realisedUsd": { "type": "string" }, "unverified": { "type": "number" }, "asOf": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, { "type": "null" } ] } }, "required": [ "positions", "openUsd", "openCostUsd", "claimableUsd", "realisedUsd", "unverified", "asOf" ] } ``` ## From an agent The MCP tool `port_predictions` answers the same question ("what prediction markets am I in") with the same figures, over the [MCP server](https://docs.getport.app/api/mcp/). ## Refusals Every endpoint shares three: `401` for a missing or dead key, `402` for an account whose plan has no API ("Agents, MCP and the API are on Pro+ and above."), and `429` past the minute or day limit. The [errors](https://docs.getport.app/api/#errors) section has each body.