Skip to content
Reference

GET /api/v1/holdings

Every holding row with its amount, its price and the confidence behind it, paged at 500.

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

curl -s https://getport.app/api/v1/holdings -H "Authorization: Bearer $PORT_API_KEY"
NameInTypeWhat it does
walletquerystringOne wallet address, to read only its rows.
chainquerystringOne chain id, to read only its rows.
hiddenquerybooleanSet to 1 or true to include the rows the product folds. Each one says why.
cursorquerystringThe cursor from the previous page.

Pages end when cursor is null; pass it back as ?cursor= for the next one. The cursor is opaque, so never build one.

total counts every row the wallets hold, folded ones included and before any ?chain= filter, so the pages add up to it only with ?hidden=1 and no chain. complete: false means the server also capped the rows it read for a port this size, and then the pages end short of total whatever you ask.

counted says whether a row is inside the headline, and hiddenReason why the app folds it; the default page is the rows with no hiddenReason. The two differ: a small row is counted and folded, and a bought token quoted below the confidence bar is on screen and not counted. /port is still the total, because DeFi, venue balances and perp equity are on no holdings row.

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.

{
"rows": [
{
"chainId": "ethereum",
"tokenAddress": "0x514910771af9ca656af840dff83e8264ecf986ca",
"symbol": "LINK",
"name": "Chainlink",
"decimals": 18,
"logoUrl": null,
"rawAmount": "420500000000000000000",
"amount": "420.5",
"acquiredVia": "swap",
"protocol": null,
"side": "asset",
"price": {
"usd": "11.84",
"liquidityUsd": "2841033.00",
"confidence": 1,
"source": "market",
"at": "2026-10-06T05:42:10.000Z"
},
"valueUsd": "4978.72",
"change24hPct": "-1.6",
"spark": [
12.03,
11.95,
11.84
],
"spam": false,
"spamReason": null,
"hiddenByYou": false,
"unsellable": null,
"walletAddress": "0x8f3c0e7b2a91d4c6f5e3b2a1908d7c6b5a4fc21a",
"counted": true,
"hiddenReason": null
}
],
"total": 214,
"cursor": "eyJvZmZzZXQiOjEwMH0",
"complete": true
}
Field of dataTypeAlways present
rowsarray of objectyes
totalintegeryes
cursorstring or nullyes
completebooleanno
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": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"chainId": {
"type": "string"
},
"tokenAddress": {
"type": "string"
},
"symbol": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"decimals": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"logoUrl": {
"type": [
"string",
"null"
]
},
"rawAmount": {
"type": "string"
},
"amount": {
"type": [
"string",
"null"
]
},
"acquiredVia": {
"type": "string",
"enum": [
"swap",
"transfer",
"airdrop",
"unknown"
]
},
"protocol": {
"type": [
"string",
"null"
]
},
"side": {
"default": "asset",
"type": "string",
"enum": [
"asset",
"liability"
]
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"usd": {
"type": "string"
},
"liquidityUsd": {
"type": [
"string",
"null"
]
},
"confidence": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"source": {
"type": "string"
},
"at": {
"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))$"
}
},
"required": [
"usd",
"liquidityUsd",
"confidence",
"source",
"at"
]
},
{
"type": "null"
}
]
},
"valueUsd": {
"type": [
"string",
"null"
]
},
"change24hPct": {
"type": [
"string",
"null"
]
},
"spark": {
"anyOf": [
{
"type": "array",
"items": {
"type": "number"
}
},
{
"type": "null"
}
]
},
"spam": {
"type": "boolean"
},
"spamReason": {
"type": [
"string",
"null"
]
},
"hiddenByYou": {
"type": "boolean"
},
"unsellable": {
"type": [
"string",
"null"
]
},
"walletAddress": {
"type": "string"
},
"counted": {
"type": "boolean"
},
"hiddenReason": {
"type": [
"string",
"null"
]
}
},
"required": [
"chainId",
"tokenAddress",
"symbol",
"name",
"decimals",
"logoUrl",
"rawAmount",
"amount",
"acquiredVia",
"protocol",
"side",
"price",
"valueUsd",
"change24hPct",
"spark",
"walletAddress",
"counted",
"hiddenReason"
]
}
},
"total": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"cursor": {
"type": [
"string",
"null"
]
},
"complete": {
"type": "boolean"
}
},
"required": [
"rows",
"total",
"cursor"
]
}

The MCP tool port_holdings answers the same question ("what do I hold, how much of it, and what is each row priced at") 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.

This endpoint also refuses:

  • 400 bad_cursor when the cursor is not one this endpoint handed out.