# GET /api/v1/holdings > Every holding row with its amount, its price and the confidence behind it, paged at 500. Source: https://docs.getport.app/api/reference/holdings/ ## Example The key is read from `PORT_API_KEY`, so the command never prints it. ```sh curl -s https://getport.app/api/v1/holdings -H "Authorization: Bearer $PORT_API_KEY" ``` ## 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. | ## Notes 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 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. ``` { "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`](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 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](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. This endpoint also refuses: - `400` `bad_cursor` when the cursor is not one this endpoint handed out.