GET /api/v1/holdings
Every holding row with its amount, its price and the confidence behind it, paged at 500.
Example
Section titled “Example”The key is read from PORT_API_KEY, so the command never prints it.
Parameters
Section titled “Parameters”| Name | In | Type | What it does |
|---|---|---|---|
wallet | query | string | One wallet address, to read only its rows. |
chain | query | string | One chain id, to read only its rows. |
hidden | query | boolean | Set to 1 or true to include the rows the product folds. Each one says why. |
cursor | query | string | The 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.
Response
Section titled “Response”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 data | Type | Always present |
|---|---|---|
rows | array of object | yes |
total | integer | yes |
cursor | string or null | yes |
complete | boolean | no |
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" ]}From an agent
Section titled “From an agent”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.
Refusals
Section titled “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 section has each body.
This endpoint also refuses:
400bad_cursorwhen the cursor is not one this endpoint handed out.