Skip to content
Reference

GET /api/v1/predictions

Polymarket and Limitless positions grouped by event, with whether the chain agreed on each.

The key is read from PORT_API_KEY, so the command never prints it.

curl -s https://getport.app/api/v1/predictions -H "Authorization: Bearer $PORT_API_KEY"

A 200 with 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 dataTypeAlways present
positionsarray of objectyes
openUsdstringyes
openCostUsdstringyes
claimableUsdstringyes
realisedUsdstringyes
unverifiednumberyes
asOfstring or nullyes
The whole schema of data

As the OpenAPI document at 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"
]
}

The MCP tool port_predictions answers the same question ("what prediction markets am I in") with the same figures, over the MCP server.

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 section has each body.