{ "info": { "_postman_id": "0becdd12-f3c5-45e3-8d04-6f6553d138eb", "name": "REST chains wallets API", "description": "REST-like API provides access to rich Zerion ecosystem.\n\nContact Support:\n Name: Zerion API\n Email: api@zerion.io", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:37:52.000Z", "updatedAt": "2026-07-28T03:37:52.000Z", "lastUpdatedBy": "35240", "uid": "35240-0becdd12-f3c5-45e3-8d04-6f6553d138eb" }, "item": [ { "name": "v1", "item": [ { "name": "wallets", "item": [ { "name": "{address}", "item": [ { "name": "charts", "item": [ { "name": "{chart_period}", "item": [ { "name": "Get wallet balance chart", "id": "596d7401-5471-4f10-8b1d-ffde78ca9521", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/charts/:chart_period?currency=usd&filter[chain_ids]=,&filter[fungible_ids]=,&filter[exclude_fungible_ids]=,&filter[pool_addresses]=,&filter[exclude_pool_addresses]=,&filter[positions]=only_simple", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "charts", ":chart_period" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Account only for balance on these chains (comma-separated list). Available chain ids can be found in chains endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Account only for balance of given fungible assets (comma-separated list). Mutually exclusive with `filter[exclude_fungible_ids]` \u2014 combining both returns `400`.", "key": "filter[fungible_ids]", "value": "," }, { "description": "Exclude balance contributions from the given fungible assets (comma-separated list). Useful when the set you want to keep is large but the set you want to omit is small. Mutually exclusive with `filter[fungible_ids]` \u2014 combining both returns `400`.", "key": "filter[exclude_fungible_ids]", "value": "," }, { "description": "Restrict the balance chart to specific liquidity-pool / vault positions, identified by their contract address (comma-separated list) \u2014 the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. Only the matching protocol positions are charted; simple token and native-coin balances are excluded. These are complex (protocol) positions, so passing `filter[positions]=only_simple` alongside this filter returns `400`. Mutually exclusive with `filter[exclude_pool_addresses]` \u2014 combining both returns `400`.", "key": "filter[pool_addresses]", "value": "," }, { "description": "Exclude specific liquidity-pool / vault positions from the balance chart, identified by their contract address (comma-separated list) \u2014 the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. The matching positions are removed; the rest of the portfolio (including simple balances) is kept. These are complex (protocol) positions, so passing `filter[positions]=only_simple` alongside this filter \u2014 which would already drop every protocol position, making the exclusion a no-op \u2014 returns `400`. Mutually exclusive with `filter[pool_addresses]` \u2014 combining both returns `400`.", "key": "filter[exclude_pool_addresses]", "value": "," }, { "description": "Which positions to include in the balance chart.\n- `only_simple` (default) \u2014 simple positions only: wallet token and native-coin balances.\n- `only_complex` \u2014 complex DeFi protocol positions only (e.g. liquidity-pool and vault positions).\n- `no_filter` \u2014 include both simple and complex positions.\n\nUniswap V2 LP positions are supported today, and support for more protocols is rolling out over time.\n", "key": "filter[positions]", "value": "only_simple" } ], "variable": [ { "id": "e4b8cc73-1104-459e-896e-9a7f7fd4c700", "key": "address", "value": "0x3eC01F58C55805DeFD84D7233aEdECEf0b58896C", "description": "(Required) The web3 wallet address. Must be a valid EVM or Solana address. Returns 400 if the address is not tracked by Zerion." }, { "id": "a4bd78d9-2fc7-40ae-809b-3ed2c1fa7b99", "key": "chart_period", "value": "day", "description": "(Required) Chart period. Determines both the time window covered and the spacing\nbetween chart points (`points`). Each period samples the window at a fixed\ninterval, so the number of points is roughly constant (~290\u2013460) regardless\nof period:\n\n| Period | Point interval | Time window |\n| ---------- | -------------- | ------------------- |\n| `hour` | 10 seconds | last 1 hour |\n| `day` | 5 minutes | last 24 hours |\n| `week` | 30 minutes | last 7 days |\n| `month` | 2 hours | last 30 days |\n| `3months` | 6 hours | last 90 days |\n| `6months` | 12 hours | last 180 days |\n| `year` | 1 day | last 365 days |\n| `5years` | 4 days | last 5 years |\n| `max` | varies | full available history |\n\nPoint counts are approximate, and `begin_at` / `end_at` are aligned to the\ninterval. For `max`, the interval is derived from the amount of available\nhistory (targeting ~400 points), so it varies; for wallet and wallet-set\ncharts the spacing is at least 1 day.\n" } ] }, "description": "This endpoint returns a portfolio balance chart for a wallet.\nThis is over a specified time period, based on the provided start and end timestamps.\nResults can be filtered by blockchain and asset type, offering flexible and detailed visualizations of wallet performance, similar to what you see in the Zerion interface.\n\n**Complex positions.** By default the chart counts only simple positions: token and native-coin balances held directly in the wallet. Set `filter[positions]` to `only_complex` or `no_filter` to also include complex DeFi protocol positions. Uniswap V2 LP positions are supported today, and support for more protocols is rolling out over time. Positions from protocols that aren't yet supported are omitted from the chart.\n" }, "response": [ { "id": "974800bd-aa94-4dd2-ae8a-8b271698bbe7", "name": "Resource for the requested wallet chart", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/charts/:chart_period?currency=usd&filter[chain_ids]=,&filter[fungible_ids]=,&filter[exclude_fungible_ids]=,&filter[pool_addresses]=,&filter[exclude_pool_addresses]=,&filter[positions]=only_simple", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "charts", ":chart_period" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Account only for balance on these chains (comma-separated list). Available chain ids can be found in chains endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Account only for balance of given fungible assets (comma-separated list). Mutually exclusive with `filter[exclude_fungible_ids]` \u2014 combining both returns `400`.", "key": "filter[fungible_ids]", "value": "," }, { "description": "Exclude balance contributions from the given fungible assets (comma-separated list). Useful when the set you want to keep is large but the set you want to omit is small. Mutually exclusive with `filter[fungible_ids]` \u2014 combining both returns `400`.", "key": "filter[exclude_fungible_ids]", "value": "," }, { "description": "Restrict the balance chart to specific liquidity-pool / vault positions, identified by their contract address (comma-separated list) \u2014 the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. Only the matching protocol positions are charted; simple token and native-coin balances are excluded. These are complex (protocol) positions, so passing `filter[positions]=only_simple` alongside this filter returns `400`. Mutually exclusive with `filter[exclude_pool_addresses]` \u2014 combining both returns `400`.", "key": "filter[pool_addresses]", "value": "," }, { "description": "Exclude specific liquidity-pool / vault positions from the balance chart, identified by their contract address (comma-separated list) \u2014 the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. The matching positions are removed; the rest of the portfolio (including simple balances) is kept. These are complex (protocol) positions, so passing `filter[positions]=only_simple` alongside this filter \u2014 which would already drop every protocol position, making the exclusion a no-op \u2014 returns `400`. Mutually exclusive with `filter[pool_addresses]` \u2014 combining both returns `400`.", "key": "filter[exclude_pool_addresses]", "value": "," }, { "description": "Which positions to include in the balance chart.\n- `only_simple` (default) \u2014 simple positions only: wallet token and native-coin balances.\n- `only_complex` \u2014 complex DeFi protocol positions only (e.g. liquidity-pool and vault positions).\n- `no_filter` \u2014 include both simple and complex positions.\n\nUniswap V2 LP positions are supported today, and support for more protocols is rolling out over time.\n", "key": "filter[positions]", "value": "only_simple" } ], "variable": [ { "key": "address" }, { "key": "chart_period" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": \"\"\n },\n \"data\": {\n \"type\": \"wallet_chart\",\n \"id\": \"\",\n \"attributes\": {\n \"begin_at\": \"\",\n \"end_at\": \"\",\n \"points\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ]\n }\n }\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-974800bd-aa94-4dd2-ae8a-8b271698bbe7" }, { "id": "4ef5ad47-6124-40cb-b7c4-bcb9b9ad35af", "name": "Parameters are malformed", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/charts/:chart_period?currency=usd&filter[chain_ids]=,&filter[fungible_ids]=,&filter[exclude_fungible_ids]=,&filter[pool_addresses]=,&filter[exclude_pool_addresses]=,&filter[positions]=only_simple", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "charts", ":chart_period" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Account only for balance on these chains (comma-separated list). Available chain ids can be found in chains endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Account only for balance of given fungible assets (comma-separated list). Mutually exclusive with `filter[exclude_fungible_ids]` \u2014 combining both returns `400`.", "key": "filter[fungible_ids]", "value": "," }, { "description": "Exclude balance contributions from the given fungible assets (comma-separated list). Useful when the set you want to keep is large but the set you want to omit is small. Mutually exclusive with `filter[fungible_ids]` \u2014 combining both returns `400`.", "key": "filter[exclude_fungible_ids]", "value": "," }, { "description": "Restrict the balance chart to specific liquidity-pool / vault positions, identified by their contract address (comma-separated list) \u2014 the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. Only the matching protocol positions are charted; simple token and native-coin balances are excluded. These are complex (protocol) positions, so passing `filter[positions]=only_simple` alongside this filter returns `400`. Mutually exclusive with `filter[exclude_pool_addresses]` \u2014 combining both returns `400`.", "key": "filter[pool_addresses]", "value": "," }, { "description": "Exclude specific liquidity-pool / vault positions from the balance chart, identified by their contract address (comma-separated list) \u2014 the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. The matching positions are removed; the rest of the portfolio (including simple balances) is kept. These are complex (protocol) positions, so passing `filter[positions]=only_simple` alongside this filter \u2014 which would already drop every protocol position, making the exclusion a no-op \u2014 returns `400`. Mutually exclusive with `filter[pool_addresses]` \u2014 combining both returns `400`.", "key": "filter[exclude_pool_addresses]", "value": "," }, { "description": "Which positions to include in the balance chart.\n- `only_simple` (default) \u2014 simple positions only: wallet token and native-coin balances.\n- `only_complex` \u2014 complex DeFi protocol positions only (e.g. liquidity-pool and vault positions).\n- `no_filter` \u2014 include both simple and complex positions.\n\nUniswap V2 LP positions are supported today, and support for more protocols is rolling out over time.\n", "key": "filter[positions]", "value": "only_simple" } ], "variable": [ { "key": "address" }, { "key": "chart_period" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-4ef5ad47-6124-40cb-b7c4-bcb9b9ad35af" }, { "id": "de91616b-ee5c-4b92-a516-1ba4ae98270a", "name": "Unathenticated request", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/charts/:chart_period?currency=usd&filter[chain_ids]=,&filter[fungible_ids]=,&filter[exclude_fungible_ids]=,&filter[pool_addresses]=,&filter[exclude_pool_addresses]=,&filter[positions]=only_simple", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "charts", ":chart_period" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Account only for balance on these chains (comma-separated list). Available chain ids can be found in chains endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Account only for balance of given fungible assets (comma-separated list). Mutually exclusive with `filter[exclude_fungible_ids]` \u2014 combining both returns `400`.", "key": "filter[fungible_ids]", "value": "," }, { "description": "Exclude balance contributions from the given fungible assets (comma-separated list). Useful when the set you want to keep is large but the set you want to omit is small. Mutually exclusive with `filter[fungible_ids]` \u2014 combining both returns `400`.", "key": "filter[exclude_fungible_ids]", "value": "," }, { "description": "Restrict the balance chart to specific liquidity-pool / vault positions, identified by their contract address (comma-separated list) \u2014 the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. Only the matching protocol positions are charted; simple token and native-coin balances are excluded. These are complex (protocol) positions, so passing `filter[positions]=only_simple` alongside this filter returns `400`. Mutually exclusive with `filter[exclude_pool_addresses]` \u2014 combining both returns `400`.", "key": "filter[pool_addresses]", "value": "," }, { "description": "Exclude specific liquidity-pool / vault positions from the balance chart, identified by their contract address (comma-separated list) \u2014 the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. The matching positions are removed; the rest of the portfolio (including simple balances) is kept. These are complex (protocol) positions, so passing `filter[positions]=only_simple` alongside this filter \u2014 which would already drop every protocol position, making the exclusion a no-op \u2014 returns `400`. Mutually exclusive with `filter[pool_addresses]` \u2014 combining both returns `400`.", "key": "filter[exclude_pool_addresses]", "value": "," }, { "description": "Which positions to include in the balance chart.\n- `only_simple` (default) \u2014 simple positions only: wallet token and native-coin balances.\n- `only_complex` \u2014 complex DeFi protocol positions only (e.g. liquidity-pool and vault positions).\n- `no_filter` \u2014 include both simple and complex positions.\n\nUniswap V2 LP positions are supported today, and support for more protocols is rolling out over time.\n", "key": "filter[positions]", "value": "only_simple" } ], "variable": [ { "key": "address" }, { "key": "chart_period" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-de91616b-ee5c-4b92-a516-1ba4ae98270a" }, { "id": "29cfcf19-6b94-48a1-9815-8470f53543e3", "name": "Too many requests error", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/charts/:chart_period?currency=usd&filter[chain_ids]=,&filter[fungible_ids]=,&filter[exclude_fungible_ids]=,&filter[pool_addresses]=,&filter[exclude_pool_addresses]=,&filter[positions]=only_simple", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "charts", ":chart_period" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Account only for balance on these chains (comma-separated list). Available chain ids can be found in chains endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Account only for balance of given fungible assets (comma-separated list). Mutually exclusive with `filter[exclude_fungible_ids]` \u2014 combining both returns `400`.", "key": "filter[fungible_ids]", "value": "," }, { "description": "Exclude balance contributions from the given fungible assets (comma-separated list). Useful when the set you want to keep is large but the set you want to omit is small. Mutually exclusive with `filter[fungible_ids]` \u2014 combining both returns `400`.", "key": "filter[exclude_fungible_ids]", "value": "," }, { "description": "Restrict the balance chart to specific liquidity-pool / vault positions, identified by their contract address (comma-separated list) \u2014 the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. Only the matching protocol positions are charted; simple token and native-coin balances are excluded. These are complex (protocol) positions, so passing `filter[positions]=only_simple` alongside this filter returns `400`. Mutually exclusive with `filter[exclude_pool_addresses]` \u2014 combining both returns `400`.", "key": "filter[pool_addresses]", "value": "," }, { "description": "Exclude specific liquidity-pool / vault positions from the balance chart, identified by their contract address (comma-separated list) \u2014 the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. The matching positions are removed; the rest of the portfolio (including simple balances) is kept. These are complex (protocol) positions, so passing `filter[positions]=only_simple` alongside this filter \u2014 which would already drop every protocol position, making the exclusion a no-op \u2014 returns `400`. Mutually exclusive with `filter[pool_addresses]` \u2014 combining both returns `400`.", "key": "filter[exclude_pool_addresses]", "value": "," }, { "description": "Which positions to include in the balance chart.\n- `only_simple` (default) \u2014 simple positions only: wallet token and native-coin balances.\n- `only_complex` \u2014 complex DeFi protocol positions only (e.g. liquidity-pool and vault positions).\n- `no_filter` \u2014 include both simple and complex positions.\n\nUniswap V2 LP positions are supported today, and support for more protocols is rolling out over time.\n", "key": "filter[positions]", "value": "only_simple" } ], "variable": [ { "key": "address" }, { "key": "chart_period" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-29cfcf19-6b94-48a1-9815-8470f53543e3" } ], "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-596d7401-5471-4f10-8b1d-ffde78ca9521" } ], "id": "16820301-bf73-4e07-a9e5-1c1c0ac9425f", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-16820301-bf73-4e07-a9e5-1c1c0ac9425f" } ], "id": "544f4bc9-c772-4080-8601-0d3de3f3c59c", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-544f4bc9-c772-4080-8601-0d3de3f3c59c" }, { "name": "pnl", "item": [ { "name": "Get wallet PnL", "id": "dca44987-13a1-4394-b49d-7a218546942b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/pnl?currency=usd&filter[chain_ids]=,&filter[fungible_ids]=,&filter[fungible_implementations]=,&since=&till=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "pnl" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Calculate PnL only for specified chains (comma-separated list).", "key": "filter[chain_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible assets (comma-separated list). Maximum of 100 fungible IDs allowed.\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible asset implementations (comma-separated list of chain:address pairs). Maximum of 100 implementations allowed.\nexample: \"base:0xae16c445d8a4082cecb49a9465e4dd5499df947d,ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\"\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_implementations]", "value": "," }, { "description": "Only account sales since the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "since", "value": "" }, { "description": "Only account sales till the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "till", "value": "" } ], "variable": [ { "id": "21283502-67d2-4244-8374-8d1c08c41a4f", "key": "address", "value": "0x3eC01F58C55805DeFD84D7233aEdECEf0b58896C", "description": "(Required) The web3 wallet address. Must be a valid EVM or Solana address. Returns 400 if the address is not tracked by Zerion." } ] }, "description": "This endpoint returns the Profit and Loss (PnL) details of a web3 wallet.\nThis includes Unrealized PnL, Realized PnL, Net Invested amounts and filters for asset categories like Non Fungible Tokens (NFTs).\nIt uses the FIFO (First In, First Out) standard for calculations, providing accurate insights into wallet performance.\nIdeal for tracking and analyzing financial outcomes of wallet activity.\n\nThe very first request for a wallet might result in a 503 which should be retried later.\nWallets with over 1 million transactions are not supported.\n" }, "response": [ { "id": "752c314d-46b0-4e96-a5b7-1869ab45a27f", "name": "Response for requested wallet's pnl", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/pnl?currency=usd&filter[chain_ids]=,&filter[fungible_ids]=,&filter[fungible_implementations]=,&since=&till=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "pnl" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Calculate PnL only for specified chains (comma-separated list).", "key": "filter[chain_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible assets (comma-separated list). Maximum of 100 fungible IDs allowed.\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible asset implementations (comma-separated list of chain:address pairs). Maximum of 100 implementations allowed.\nexample: \"base:0xae16c445d8a4082cecb49a9465e4dd5499df947d,ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\"\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_implementations]", "value": "," }, { "description": "Only account sales since the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "since", "value": "" }, { "description": "Only account sales till the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "till", "value": "" } ], "variable": [ { "key": "address" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": \"\"\n },\n \"data\": {\n \"type\": \"pnl\",\n \"id\": \"\",\n \"attributes\": {\n \"total_gain\": \"\",\n \"realized_gain\": \"\",\n \"unrealized_gain\": \"\",\n \"relative_total_gain_percentage\": \"\",\n \"relative_realized_gain_percentage\": \"\",\n \"relative_unrealized_gain_percentage\": \"\",\n \"total_fee\": \"\",\n \"total_invested\": \"\",\n \"realized_cost_basis\": \"\",\n \"net_invested\": \"\",\n \"received_external\": \"\",\n \"sent_external\": \"\",\n \"sent_for_nfts\": \"\",\n \"received_for_nfts\": \"\",\n \"breakdown\": {\n \"by_id\": {\n \"dolore_4\": {\n \"average_buy_price\": \"\",\n \"average_sell_price\": \"\",\n \"total_gain\": \"\",\n \"realized_gain\": \"\",\n \"unrealized_gain\": \"\",\n \"relative_total_gain_percentage\": \"\",\n \"relative_realized_gain_percentage\": \"\",\n \"relative_unrealized_gain_percentage\": \"\",\n \"total_fee\": \"\",\n \"total_invested\": \"\",\n \"realized_cost_basis\": \"\",\n \"net_invested\": \"\",\n \"received_external\": \"\",\n \"sent_external\": \"\",\n \"sent_for_nfts\": \"\",\n \"received_for_nfts\": \"\"\n }\n },\n \"by_implementation\": {\n \"et3\": {\n \"average_buy_price\": \"\",\n \"average_sell_price\": \"\",\n \"total_gain\": \"\",\n \"realized_gain\": \"\",\n \"unrealized_gain\": \"\",\n \"relative_total_gain_percentage\": \"\",\n \"relative_realized_gain_percentage\": \"\",\n \"relative_unrealized_gain_percentage\": \"\",\n \"total_fee\": \"\",\n \"total_invested\": \"\",\n \"realized_cost_basis\": \"\",\n \"net_invested\": \"\",\n \"received_external\": \"\",\n \"sent_external\": \"\",\n \"sent_for_nfts\": \"\",\n \"received_for_nfts\": \"\"\n },\n \"id_1ea\": {\n \"average_buy_price\": \"\",\n \"average_sell_price\": \"\",\n \"total_gain\": \"\",\n \"realized_gain\": \"\",\n \"unrealized_gain\": \"\",\n \"relative_total_gain_percentage\": \"\",\n \"relative_realized_gain_percentage\": \"\",\n \"relative_unrealized_gain_percentage\": \"\",\n \"total_fee\": \"\",\n \"total_invested\": \"\",\n \"realized_cost_basis\": \"\",\n \"net_invested\": \"\",\n \"received_external\": \"\",\n \"sent_external\": \"\",\n \"sent_for_nfts\": \"\",\n \"received_for_nfts\": \"\"\n },\n \"do37\": {\n \"average_buy_price\": \"\",\n \"average_sell_price\": \"\",\n \"total_gain\": \"\",\n \"realized_gain\": \"\",\n \"unrealized_gain\": \"\",\n \"relative_total_gain_percentage\": \"\",\n \"relative_realized_gain_percentage\": \"\",\n \"relative_unrealized_gain_percentage\": \"\",\n \"total_fee\": \"\",\n \"total_invested\": \"\",\n \"realized_cost_basis\": \"\",\n \"net_invested\": \"\",\n \"received_external\": \"\",\n \"sent_external\": \"\",\n \"sent_for_nfts\": \"\",\n \"received_for_nfts\": \"\"\n },\n \"adaa6\": {\n \"average_buy_price\": \"\",\n \"average_sell_price\": \"\",\n \"total_gain\": \"\",\n \"realized_gain\": \"\",\n \"unrealized_gain\": \"\",\n \"relative_total_gain_percentage\": \"\",\n \"relative_realized_gain_percentage\": \"\",\n \"relative_unrealized_gain_percentage\": \"\",\n \"total_fee\": \"\",\n \"total_invested\": \"\",\n \"realized_cost_basis\": \"\",\n \"net_invested\": \"\",\n \"received_external\": \"\",\n \"sent_external\": \"\",\n \"sent_for_nfts\": \"\",\n \"received_for_nfts\": \"\"\n }\n }\n }\n }\n },\n \"meta\": {\n \"excluded_fungible_ids\": [\n \"\",\n \"\"\n ],\n \"excluded_fungible_implementations\": [\n \"\",\n \"\"\n ]\n }\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-752c314d-46b0-4e96-a5b7-1869ab45a27f" }, { "id": "f6788f23-bd65-4ddc-85b1-bea5270cca60", "name": "Parameters are malformed", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/pnl?currency=usd&filter[chain_ids]=,&filter[fungible_ids]=,&filter[fungible_implementations]=,&since=&till=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "pnl" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Calculate PnL only for specified chains (comma-separated list).", "key": "filter[chain_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible assets (comma-separated list). Maximum of 100 fungible IDs allowed.\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible asset implementations (comma-separated list of chain:address pairs). Maximum of 100 implementations allowed.\nexample: \"base:0xae16c445d8a4082cecb49a9465e4dd5499df947d,ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\"\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_implementations]", "value": "," }, { "description": "Only account sales since the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "since", "value": "" }, { "description": "Only account sales till the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "till", "value": "" } ], "variable": [ { "key": "address" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-f6788f23-bd65-4ddc-85b1-bea5270cca60" }, { "id": "be834040-0df1-4afb-abf6-3b92762a1ed8", "name": "Unathenticated request", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/pnl?currency=usd&filter[chain_ids]=,&filter[fungible_ids]=,&filter[fungible_implementations]=,&since=&till=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "pnl" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Calculate PnL only for specified chains (comma-separated list).", "key": "filter[chain_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible assets (comma-separated list). Maximum of 100 fungible IDs allowed.\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible asset implementations (comma-separated list of chain:address pairs). Maximum of 100 implementations allowed.\nexample: \"base:0xae16c445d8a4082cecb49a9465e4dd5499df947d,ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\"\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_implementations]", "value": "," }, { "description": "Only account sales since the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "since", "value": "" }, { "description": "Only account sales till the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "till", "value": "" } ], "variable": [ { "key": "address" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-be834040-0df1-4afb-abf6-3b92762a1ed8" }, { "id": "371708bb-70c4-45fb-8dba-755288181ebb", "name": "Too many requests error", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/pnl?currency=usd&filter[chain_ids]=,&filter[fungible_ids]=,&filter[fungible_implementations]=,&since=&till=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "pnl" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Calculate PnL only for specified chains (comma-separated list).", "key": "filter[chain_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible assets (comma-separated list). Maximum of 100 fungible IDs allowed.\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible asset implementations (comma-separated list of chain:address pairs). Maximum of 100 implementations allowed.\nexample: \"base:0xae16c445d8a4082cecb49a9465e4dd5499df947d,ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\"\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_implementations]", "value": "," }, { "description": "Only account sales since the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "since", "value": "" }, { "description": "Only account sales till the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "till", "value": "" } ], "variable": [ { "key": "address" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-371708bb-70c4-45fb-8dba-755288181ebb" }, { "id": "5d253404-e6b0-4daa-9e2a-ca521642feb6", "name": "Service is temporarily unavailable", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/pnl?currency=usd&filter[chain_ids]=,&filter[fungible_ids]=,&filter[fungible_implementations]=,&since=&till=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "pnl" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Calculate PnL only for specified chains (comma-separated list).", "key": "filter[chain_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible assets (comma-separated list). Maximum of 100 fungible IDs allowed.\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_ids]", "value": "," }, { "description": "Account only for PnL related to given fungible asset implementations (comma-separated list of chain:address pairs). Maximum of 100 implementations allowed.\nexample: \"base:0xae16c445d8a4082cecb49a9465e4dd5499df947d,ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\"\n\nWhen filtering by fungible_ids or fungible_implementations, assets without available prices are automatically excluded from calculations instead of causing an error. Excluded assets are returned in the response metadata for transparency.\n", "key": "filter[fungible_implementations]", "value": "," }, { "description": "Only account sales since the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "since", "value": "" }, { "description": "Only account sales till the given date.\nA unix timestamp in milliseconds.\n**Note:** PnL is pre-computed at standard marks (`now`, `1 day ago`, `1 week ago`, `1 month ago`, `1 year ago`, `beginning of the year`). Other values are supported only if fewer than 3,000 transactions sit between your timestamp and the nearest mark \u2014 otherwise the request errors out.", "key": "till", "value": "" } ], "variable": [ { "key": "address" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Indicates how long the client should wait before making a follow-up request.\n", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-5d253404-e6b0-4daa-9e2a-ca521642feb6" } ], "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-dca44987-13a1-4394-b49d-7a218546942b" } ], "id": "66fd9450-1298-41c6-a41a-07c10029152d", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-66fd9450-1298-41c6-a41a-07c10029152d" }, { "name": "portfolio", "item": [ { "name": "Get wallet portfolio", "id": "0355e4e3-6378-4f70-a368-28e0fd3dd8d0", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/portfolio?filter[positions]=only_simple¤cy=usd", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "portfolio" ], "query": [ { "description": "This parameter allows to customize the aggregation of DeFi positions within a portfolio based on their types. The aggregation can include:\n\n - `only_simple`: Only includes wallet-type positions, which are basic, non-protocol related assets. This is the default selection if the parameter is not specified.\n - `only_complex`: Aggregates positions associated with DeFi protocols only (e.g., staked assets, liquidity pools), like Uniswap or Aave, excluding simple wallet positions.\n - `no_filter`: Provides an aggregated view of both protocol-related and simple wallet positions without any filtering.\n\nThe selection of filters affects the composition of the aggregated portfolio results, allowing for tailored analysis and reporting based on the types of positions of interest.\n\n> \u26a0\ufe0f Note: Enterprise usage of this API may be subject to different pricing models depending on the selected filter type. For detailed pricing information, please contact `api@zerion.io`.\n", "key": "filter[positions]", "value": "only_simple" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" } ], "variable": [ { "id": "16cdae0d-20e3-4242-9e90-62c92dc586d2", "key": "address", "value": "0x3eC01F58C55805DeFD84D7233aEdECEf0b58896C", "description": "(Required) The web3 wallet address. Must be a valid EVM or Solana address. Returns 400 if the address is not tracked by Zerion." } ] }, "description": "This endpoint returns the portfolio overview of a web3 wallet.\n\n**Temporary limitations for Solana addresses:**\n- Doesn't support protocol positions\n\n> NOTE: Don't forget to stop retries after some reasonable period of time. If the `200` status is not returned within 2 minutes it most probably means that some unexpected error occurred and the client should stop the polling.\n\n> NOTE: Consider all IDs as abstract strings, without making any assumptions about their format or relying on such assumptions. There is a non-zero probability that IDs may change in the future, and this should not result in any breaking changes.\n" }, "response": [ { "id": "b69f97f6-64e9-4fd9-bb45-45966dfee2ae", "name": "Response for requested wallet's portfolio", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/portfolio?filter[positions]=only_simple¤cy=usd", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "portfolio" ], "query": [ { "description": "This parameter allows to customize the aggregation of DeFi positions within a portfolio based on their types. The aggregation can include:\n\n - `only_simple`: Only includes wallet-type positions, which are basic, non-protocol related assets. This is the default selection if the parameter is not specified.\n - `only_complex`: Aggregates positions associated with DeFi protocols only (e.g., staked assets, liquidity pools), like Uniswap or Aave, excluding simple wallet positions.\n - `no_filter`: Provides an aggregated view of both protocol-related and simple wallet positions without any filtering.\n\nThe selection of filters affects the composition of the aggregated portfolio results, allowing for tailored analysis and reporting based on the types of positions of interest.\n\n> \u26a0\ufe0f Note: Enterprise usage of this API may be subject to different pricing models depending on the selected filter type. For detailed pricing information, please contact `api@zerion.io`.\n", "key": "filter[positions]", "value": "only_simple" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" } ], "variable": [ { "key": "address" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": \"\"\n },\n \"data\": {\n \"type\": \"portfolio\",\n \"id\": \"\",\n \"attributes\": {\n \"positions_distribution_by_type\": {\n \"wallet\": \"\",\n \"deposited\": \"\",\n \"borrowed\": \"\",\n \"locked\": \"\",\n \"staked\": \"\"\n },\n \"positions_distribution_by_chain\": {\n \"laborise7d\": \"\",\n \"exercitatione_\": \"\",\n \"idfb3\": \"\"\n },\n \"total\": {\n \"positions\": \"\"\n },\n \"changes\": {\n \"absolute_1d\": \"\",\n \"percent_1d\": \"\"\n }\n }\n }\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-b69f97f6-64e9-4fd9-bb45-45966dfee2ae" }, { "id": "0e806a59-baa6-4e2b-9a8e-68c7eb093b66", "name": "Parameters are malformed", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/portfolio?filter[positions]=only_simple¤cy=usd", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "portfolio" ], "query": [ { "description": "This parameter allows to customize the aggregation of DeFi positions within a portfolio based on their types. The aggregation can include:\n\n - `only_simple`: Only includes wallet-type positions, which are basic, non-protocol related assets. This is the default selection if the parameter is not specified.\n - `only_complex`: Aggregates positions associated with DeFi protocols only (e.g., staked assets, liquidity pools), like Uniswap or Aave, excluding simple wallet positions.\n - `no_filter`: Provides an aggregated view of both protocol-related and simple wallet positions without any filtering.\n\nThe selection of filters affects the composition of the aggregated portfolio results, allowing for tailored analysis and reporting based on the types of positions of interest.\n\n> \u26a0\ufe0f Note: Enterprise usage of this API may be subject to different pricing models depending on the selected filter type. For detailed pricing information, please contact `api@zerion.io`.\n", "key": "filter[positions]", "value": "only_simple" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" } ], "variable": [ { "key": "address" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-0e806a59-baa6-4e2b-9a8e-68c7eb093b66" }, { "id": "21ce584d-9bd7-417f-8249-6f448749ebcd", "name": "Unathenticated request", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/portfolio?filter[positions]=only_simple¤cy=usd", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "portfolio" ], "query": [ { "description": "This parameter allows to customize the aggregation of DeFi positions within a portfolio based on their types. The aggregation can include:\n\n - `only_simple`: Only includes wallet-type positions, which are basic, non-protocol related assets. This is the default selection if the parameter is not specified.\n - `only_complex`: Aggregates positions associated with DeFi protocols only (e.g., staked assets, liquidity pools), like Uniswap or Aave, excluding simple wallet positions.\n - `no_filter`: Provides an aggregated view of both protocol-related and simple wallet positions without any filtering.\n\nThe selection of filters affects the composition of the aggregated portfolio results, allowing for tailored analysis and reporting based on the types of positions of interest.\n\n> \u26a0\ufe0f Note: Enterprise usage of this API may be subject to different pricing models depending on the selected filter type. For detailed pricing information, please contact `api@zerion.io`.\n", "key": "filter[positions]", "value": "only_simple" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" } ], "variable": [ { "key": "address" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-21ce584d-9bd7-417f-8249-6f448749ebcd" }, { "id": "8ab0e1eb-9078-429d-9edc-3e951530fa13", "name": "Too many requests error", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/portfolio?filter[positions]=only_simple¤cy=usd", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "portfolio" ], "query": [ { "description": "This parameter allows to customize the aggregation of DeFi positions within a portfolio based on their types. The aggregation can include:\n\n - `only_simple`: Only includes wallet-type positions, which are basic, non-protocol related assets. This is the default selection if the parameter is not specified.\n - `only_complex`: Aggregates positions associated with DeFi protocols only (e.g., staked assets, liquidity pools), like Uniswap or Aave, excluding simple wallet positions.\n - `no_filter`: Provides an aggregated view of both protocol-related and simple wallet positions without any filtering.\n\nThe selection of filters affects the composition of the aggregated portfolio results, allowing for tailored analysis and reporting based on the types of positions of interest.\n\n> \u26a0\ufe0f Note: Enterprise usage of this API may be subject to different pricing models depending on the selected filter type. For detailed pricing information, please contact `api@zerion.io`.\n", "key": "filter[positions]", "value": "only_simple" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" } ], "variable": [ { "key": "address" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-8ab0e1eb-9078-429d-9edc-3e951530fa13" } ], "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-0355e4e3-6378-4f70-a368-28e0fd3dd8d0" } ], "id": "eeaaaa4e-9293-41d3-94c9-55b5fb3824d5", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-eeaaaa4e-9293-41d3-94c9-55b5fb3824d5" }, { "name": "positions", "item": [ { "name": "Get wallet fungible positions", "id": "af2bde64-350b-460d-b02c-5d911a75c49a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/positions/?filter[positions]=only_simple¤cy=usd&filter[position_types]=wallet,locked&filter[chain_ids]=,&filter[fungible_ids]=,&filter[dapp_ids]=,&filter[trash]=only_non_trash&sort=value", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "positions", "" ], "query": [ { "description": "This parameter allows users to filter DeFi positions based on their types. There are three options:\n\n- `only_simple`: Retrieves exclusively wallet-type positions. These are basic, non-protocol related positions. This option is applied if parameter is not specified.\n- `only_complex`: Fetches only positions associated with all DeFi protocols (including staked assets, liquidity pools, etc), like Uniswap or Aave. This option excludes simple wallet positions.\n- `no_filter`: Applies no filtering, thus returning both protocol-related and simple wallet positions.\n\n> \u26a0\ufe0f Note: Different pricing models are applied for enterprise usage of this API, depending on the filter type selected. For detailed pricing information, please reach out to us at `api@zerion.io`.\n", "key": "filter[positions]", "value": "only_simple" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Keep only positions with these types (comma-separated list).\n\nPossible values:\n- `deposit` - Assets deposited into a DeFi protocol (e.g., supplied to lending pools, deposited in vaults, or provided as liquidity)\n- `loan` - Borrowed assets representing a debt position that needs to be repaid\n- `locked` - Assets locked for a specific period or purpose (e.g., vote-escrowed tokens, time-locked tokens)\n- `staked` - Assets staked in a protocol to earn rewards, participate in consensus, or for governance purposes\n- `reward` - Earned rewards that are claimable or have been distributed but not yet withdrawn\n- `wallet` - Regular assets held directly in the wallet, not actively deposited in any protocol\n- `investment` - Investment positions such as tokenized funds, indices, or structured products\n", "key": "filter[position_types]", "value": "wallet,locked" }, { "description": "Keep only positions from these chains (comma-separated list). Available chain ids can be found in chains endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions related to given fungible assets (comma-separated list).", "key": "filter[fungible_ids]", "value": "," }, { "description": "Keep only positions related to these decentralized applications (dapps) (comma-separated list).", "key": "filter[dapp_ids]", "value": "," }, { "description": "Filter positions based on the `is_trash` flag. If no flag is specified, then `only_non_trash` is applied.", "key": "filter[trash]", "value": "only_non_trash" }, { "description": "Choose how the result should be ordered", "key": "sort", "value": "value" } ], "variable": [ { "id": "59f5141c-d84a-4645-a866-aeb685c91766", "key": "address", "value": "0x3eC01F58C55805DeFD84D7233aEdECEf0b58896C", "description": "(Required) The web3 wallet address. Must be a valid EVM or Solana address. Returns 400 if the address is not tracked by Zerion." } ] }, "description": "This endpoint returns a list of wallet positions.\n\nThis endpoint supports testnets. To get data for testnets use `X-Env` header.\n\n**Understanding Liquidity Pool Positions:**\n\nLiquidity pools (Uniswap, Curve, Balancer, etc.) return **multiple positions** - one for each token in the pool. Positions belonging to the same pool share the same `group_id` value in attributes.\n\nFor example, a Uniswap V2 USDC/WETH pool returns two positions:\n- Position 1: WETH token, `group_id=\"820ee2f1ca8ccb716f6beb5e450908a028be890ec44aba87c739b416ef41e197\"`, `fungible_info.symbol=\"WETH\"`\n- Position 2: USDC token, `group_id=\"820ee2f1ca8ccb716f6beb5e450908a028be890ec44aba87c739b416ef41e197\"`, `fungible_info.symbol=\"USDC\"`\n\nTo display all tokens in a liquidity pool together, group positions by their `group_id` attribute.\n\n**Temporary limitations for Solana addresses:**\n- Doesn't support protocol positions\n\n> NOTE: Don't forget to stop retries after some reasonable period of time. If the `200` status is not returned within 2 minutes it most probably means that some unexpected error occurred and the client should stop the polling.\n\n> NOTE: This endpoint is not paginated and returns all matching positions in a single response. It supports a lot of filters and sorting parameters, so make sure that a request URL length is in a safe range for your platform. Usually, 2000 characters are the safe limit in virtually any combination of client and server software.\n\n> NOTE: Consider all IDs as abstract strings, without making any assumptions about their format or relying on such assumptions. There is a non-zero probability that IDs may change in the future, and this should not result in any breaking changes.\n" }, "response": [ { "id": "b0958bf2-5f74-49de-a0a6-45623e6f350e", "name": "Response for requested list of positions", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/positions/?filter[positions]=only_simple¤cy=usd&filter[position_types]=wallet,locked&filter[chain_ids]=,&filter[fungible_ids]=,&filter[dapp_ids]=,&filter[trash]=only_non_trash&sort=value", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "positions", "" ], "query": [ { "description": "This parameter allows users to filter DeFi positions based on their types. There are three options:\n\n- `only_simple`: Retrieves exclusively wallet-type positions. These are basic, non-protocol related positions. This option is applied if parameter is not specified.\n- `only_complex`: Fetches only positions associated with all DeFi protocols (including staked assets, liquidity pools, etc), like Uniswap or Aave. This option excludes simple wallet positions.\n- `no_filter`: Applies no filtering, thus returning both protocol-related and simple wallet positions.\n\n> \u26a0\ufe0f Note: Different pricing models are applied for enterprise usage of this API, depending on the filter type selected. For detailed pricing information, please reach out to us at `api@zerion.io`.\n", "key": "filter[positions]", "value": "only_simple" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Keep only positions with these types (comma-separated list).\n\nPossible values:\n- `deposit` - Assets deposited into a DeFi protocol (e.g., supplied to lending pools, deposited in vaults, or provided as liquidity)\n- `loan` - Borrowed assets representing a debt position that needs to be repaid\n- `locked` - Assets locked for a specific period or purpose (e.g., vote-escrowed tokens, time-locked tokens)\n- `staked` - Assets staked in a protocol to earn rewards, participate in consensus, or for governance purposes\n- `reward` - Earned rewards that are claimable or have been distributed but not yet withdrawn\n- `wallet` - Regular assets held directly in the wallet, not actively deposited in any protocol\n- `investment` - Investment positions such as tokenized funds, indices, or structured products\n", "key": "filter[position_types]", "value": "wallet,locked" }, { "description": "Keep only positions from these chains (comma-separated list). Available chain ids can be found in chains endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions related to given fungible assets (comma-separated list).", "key": "filter[fungible_ids]", "value": "," }, { "description": "Keep only positions related to these decentralized applications (dapps) (comma-separated list).", "key": "filter[dapp_ids]", "value": "," }, { "description": "Filter positions based on the `is_trash` flag. If no flag is specified, then `only_non_trash` is applied.", "key": "filter[trash]", "value": "only_non_trash" }, { "description": "Choose how the result should be ordered", "key": "sort", "value": "value" } ], "variable": [ { "key": "address" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": \"\"\n },\n \"data\": [\n {\n \"type\": \"positions\",\n \"id\": \"\",\n \"attributes\": {\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"name\": \"\",\n \"parent\": \"\",\n \"protocol\": \"\",\n \"protocol_module\": \"\",\n \"pool_address\": \"\",\n \"group_id\": \"\",\n \"position_type\": \"reward\",\n \"value\": \"\",\n \"price\": \"\",\n \"changes\": {\n \"absolute_1d\": \"\",\n \"percent_1d\": \"\"\n },\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"flags\": {\n \"displayable\": \"\",\n \"is_trash\": \"\"\n },\n \"updated_at\": \"\",\n \"updated_at_block\": \"\",\n \"application_metadata\": {\n \"name\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"url\": \"\"\n },\n \"receipt\": {\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n }\n }\n },\n \"relationships\": {\n \"chain\": {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"fungible\": {\n \"links\": {\n \"related\": {\n \"example\": \"https://api.zerion.io/v1/fungibles/0x111c47865ade3b172a928df8f990bc7f2a3b9aaa\"\n }\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"dapp\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n }\n },\n {\n \"type\": \"positions\",\n \"id\": \"\",\n \"attributes\": {\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"name\": \"\",\n \"parent\": \"\",\n \"protocol\": \"\",\n \"protocol_module\": \"\",\n \"pool_address\": \"\",\n \"group_id\": \"\",\n \"position_type\": \"investment\",\n \"value\": \"\",\n \"price\": \"\",\n \"changes\": {\n \"absolute_1d\": \"\",\n \"percent_1d\": \"\"\n },\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"flags\": {\n \"displayable\": \"\",\n \"is_trash\": \"\"\n },\n \"updated_at\": \"\",\n \"updated_at_block\": \"\",\n \"application_metadata\": {\n \"name\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"url\": \"\"\n },\n \"receipt\": {\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n }\n }\n },\n \"relationships\": {\n \"chain\": {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"fungible\": {\n \"links\": {\n \"related\": {\n \"example\": \"https://api.zerion.io/v1/fungibles/0x111c47865ade3b172a928df8f990bc7f2a3b9aaa\"\n }\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"dapp\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n }\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-b0958bf2-5f74-49de-a0a6-45623e6f350e" }, { "id": "51666ec0-7c65-46c3-8eaf-2ccb00749fc4", "name": "Parameters are malformed", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/positions/?filter[positions]=only_simple¤cy=usd&filter[position_types]=wallet,locked&filter[chain_ids]=,&filter[fungible_ids]=,&filter[dapp_ids]=,&filter[trash]=only_non_trash&sort=value", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "positions", "" ], "query": [ { "description": "This parameter allows users to filter DeFi positions based on their types. There are three options:\n\n- `only_simple`: Retrieves exclusively wallet-type positions. These are basic, non-protocol related positions. This option is applied if parameter is not specified.\n- `only_complex`: Fetches only positions associated with all DeFi protocols (including staked assets, liquidity pools, etc), like Uniswap or Aave. This option excludes simple wallet positions.\n- `no_filter`: Applies no filtering, thus returning both protocol-related and simple wallet positions.\n\n> \u26a0\ufe0f Note: Different pricing models are applied for enterprise usage of this API, depending on the filter type selected. For detailed pricing information, please reach out to us at `api@zerion.io`.\n", "key": "filter[positions]", "value": "only_simple" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Keep only positions with these types (comma-separated list).\n\nPossible values:\n- `deposit` - Assets deposited into a DeFi protocol (e.g., supplied to lending pools, deposited in vaults, or provided as liquidity)\n- `loan` - Borrowed assets representing a debt position that needs to be repaid\n- `locked` - Assets locked for a specific period or purpose (e.g., vote-escrowed tokens, time-locked tokens)\n- `staked` - Assets staked in a protocol to earn rewards, participate in consensus, or for governance purposes\n- `reward` - Earned rewards that are claimable or have been distributed but not yet withdrawn\n- `wallet` - Regular assets held directly in the wallet, not actively deposited in any protocol\n- `investment` - Investment positions such as tokenized funds, indices, or structured products\n", "key": "filter[position_types]", "value": "wallet,locked" }, { "description": "Keep only positions from these chains (comma-separated list). Available chain ids can be found in chains endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions related to given fungible assets (comma-separated list).", "key": "filter[fungible_ids]", "value": "," }, { "description": "Keep only positions related to these decentralized applications (dapps) (comma-separated list).", "key": "filter[dapp_ids]", "value": "," }, { "description": "Filter positions based on the `is_trash` flag. If no flag is specified, then `only_non_trash` is applied.", "key": "filter[trash]", "value": "only_non_trash" }, { "description": "Choose how the result should be ordered", "key": "sort", "value": "value" } ], "variable": [ { "key": "address" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-51666ec0-7c65-46c3-8eaf-2ccb00749fc4" }, { "id": "3717767d-ecf4-4ca7-8f11-29a83d865fb0", "name": "Unathenticated request", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/positions/?filter[positions]=only_simple¤cy=usd&filter[position_types]=wallet,locked&filter[chain_ids]=,&filter[fungible_ids]=,&filter[dapp_ids]=,&filter[trash]=only_non_trash&sort=value", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "positions", "" ], "query": [ { "description": "This parameter allows users to filter DeFi positions based on their types. There are three options:\n\n- `only_simple`: Retrieves exclusively wallet-type positions. These are basic, non-protocol related positions. This option is applied if parameter is not specified.\n- `only_complex`: Fetches only positions associated with all DeFi protocols (including staked assets, liquidity pools, etc), like Uniswap or Aave. This option excludes simple wallet positions.\n- `no_filter`: Applies no filtering, thus returning both protocol-related and simple wallet positions.\n\n> \u26a0\ufe0f Note: Different pricing models are applied for enterprise usage of this API, depending on the filter type selected. For detailed pricing information, please reach out to us at `api@zerion.io`.\n", "key": "filter[positions]", "value": "only_simple" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Keep only positions with these types (comma-separated list).\n\nPossible values:\n- `deposit` - Assets deposited into a DeFi protocol (e.g., supplied to lending pools, deposited in vaults, or provided as liquidity)\n- `loan` - Borrowed assets representing a debt position that needs to be repaid\n- `locked` - Assets locked for a specific period or purpose (e.g., vote-escrowed tokens, time-locked tokens)\n- `staked` - Assets staked in a protocol to earn rewards, participate in consensus, or for governance purposes\n- `reward` - Earned rewards that are claimable or have been distributed but not yet withdrawn\n- `wallet` - Regular assets held directly in the wallet, not actively deposited in any protocol\n- `investment` - Investment positions such as tokenized funds, indices, or structured products\n", "key": "filter[position_types]", "value": "wallet,locked" }, { "description": "Keep only positions from these chains (comma-separated list). Available chain ids can be found in chains endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions related to given fungible assets (comma-separated list).", "key": "filter[fungible_ids]", "value": "," }, { "description": "Keep only positions related to these decentralized applications (dapps) (comma-separated list).", "key": "filter[dapp_ids]", "value": "," }, { "description": "Filter positions based on the `is_trash` flag. If no flag is specified, then `only_non_trash` is applied.", "key": "filter[trash]", "value": "only_non_trash" }, { "description": "Choose how the result should be ordered", "key": "sort", "value": "value" } ], "variable": [ { "key": "address" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-3717767d-ecf4-4ca7-8f11-29a83d865fb0" }, { "id": "e59876ab-89bd-4e95-b3e0-86ca12ba754b", "name": "Too many requests error", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/positions/?filter[positions]=only_simple¤cy=usd&filter[position_types]=wallet,locked&filter[chain_ids]=,&filter[fungible_ids]=,&filter[dapp_ids]=,&filter[trash]=only_non_trash&sort=value", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "positions", "" ], "query": [ { "description": "This parameter allows users to filter DeFi positions based on their types. There are three options:\n\n- `only_simple`: Retrieves exclusively wallet-type positions. These are basic, non-protocol related positions. This option is applied if parameter is not specified.\n- `only_complex`: Fetches only positions associated with all DeFi protocols (including staked assets, liquidity pools, etc), like Uniswap or Aave. This option excludes simple wallet positions.\n- `no_filter`: Applies no filtering, thus returning both protocol-related and simple wallet positions.\n\n> \u26a0\ufe0f Note: Different pricing models are applied for enterprise usage of this API, depending on the filter type selected. For detailed pricing information, please reach out to us at `api@zerion.io`.\n", "key": "filter[positions]", "value": "only_simple" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Keep only positions with these types (comma-separated list).\n\nPossible values:\n- `deposit` - Assets deposited into a DeFi protocol (e.g., supplied to lending pools, deposited in vaults, or provided as liquidity)\n- `loan` - Borrowed assets representing a debt position that needs to be repaid\n- `locked` - Assets locked for a specific period or purpose (e.g., vote-escrowed tokens, time-locked tokens)\n- `staked` - Assets staked in a protocol to earn rewards, participate in consensus, or for governance purposes\n- `reward` - Earned rewards that are claimable or have been distributed but not yet withdrawn\n- `wallet` - Regular assets held directly in the wallet, not actively deposited in any protocol\n- `investment` - Investment positions such as tokenized funds, indices, or structured products\n", "key": "filter[position_types]", "value": "wallet,locked" }, { "description": "Keep only positions from these chains (comma-separated list). Available chain ids can be found in chains endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions related to given fungible assets (comma-separated list).", "key": "filter[fungible_ids]", "value": "," }, { "description": "Keep only positions related to these decentralized applications (dapps) (comma-separated list).", "key": "filter[dapp_ids]", "value": "," }, { "description": "Filter positions based on the `is_trash` flag. If no flag is specified, then `only_non_trash` is applied.", "key": "filter[trash]", "value": "only_non_trash" }, { "description": "Choose how the result should be ordered", "key": "sort", "value": "value" } ], "variable": [ { "key": "address" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-e59876ab-89bd-4e95-b3e0-86ca12ba754b" }, { "id": "f6d72147-cc5f-481b-81be-971ce8423d4c", "name": "Service is temporarily unavailable", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/positions/?filter[positions]=only_simple¤cy=usd&filter[position_types]=wallet,locked&filter[chain_ids]=,&filter[fungible_ids]=,&filter[dapp_ids]=,&filter[trash]=only_non_trash&sort=value", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "positions", "" ], "query": [ { "description": "This parameter allows users to filter DeFi positions based on their types. There are three options:\n\n- `only_simple`: Retrieves exclusively wallet-type positions. These are basic, non-protocol related positions. This option is applied if parameter is not specified.\n- `only_complex`: Fetches only positions associated with all DeFi protocols (including staked assets, liquidity pools, etc), like Uniswap or Aave. This option excludes simple wallet positions.\n- `no_filter`: Applies no filtering, thus returning both protocol-related and simple wallet positions.\n\n> \u26a0\ufe0f Note: Different pricing models are applied for enterprise usage of this API, depending on the filter type selected. For detailed pricing information, please reach out to us at `api@zerion.io`.\n", "key": "filter[positions]", "value": "only_simple" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Keep only positions with these types (comma-separated list).\n\nPossible values:\n- `deposit` - Assets deposited into a DeFi protocol (e.g., supplied to lending pools, deposited in vaults, or provided as liquidity)\n- `loan` - Borrowed assets representing a debt position that needs to be repaid\n- `locked` - Assets locked for a specific period or purpose (e.g., vote-escrowed tokens, time-locked tokens)\n- `staked` - Assets staked in a protocol to earn rewards, participate in consensus, or for governance purposes\n- `reward` - Earned rewards that are claimable or have been distributed but not yet withdrawn\n- `wallet` - Regular assets held directly in the wallet, not actively deposited in any protocol\n- `investment` - Investment positions such as tokenized funds, indices, or structured products\n", "key": "filter[position_types]", "value": "wallet,locked" }, { "description": "Keep only positions from these chains (comma-separated list). Available chain ids can be found in chains endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions related to given fungible assets (comma-separated list).", "key": "filter[fungible_ids]", "value": "," }, { "description": "Keep only positions related to these decentralized applications (dapps) (comma-separated list).", "key": "filter[dapp_ids]", "value": "," }, { "description": "Filter positions based on the `is_trash` flag. If no flag is specified, then `only_non_trash` is applied.", "key": "filter[trash]", "value": "only_non_trash" }, { "description": "Choose how the result should be ordered", "key": "sort", "value": "value" } ], "variable": [ { "key": "address" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Indicates how long the client should wait before making a follow-up request.\n", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-f6d72147-cc5f-481b-81be-971ce8423d4c" } ], "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-af2bde64-350b-460d-b02c-5d911a75c49a" } ], "id": "4e46b7a8-a17b-45ed-9af7-3a931aa4a0cd", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-4e46b7a8-a17b-45ed-9af7-3a931aa4a0cd" }, { "name": "transactions", "item": [ { "name": "Get wallet transactions", "id": "80791e43-a7d9-45e4-915b-d74fcd02b0b6", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/transactions/?currency=usd&page[after]=&page[size]=100&filter[search_query]=&filter[operation_types]=delegate,revoke&filter[asset_types]=fungible,fungible&filter[chain_ids]=,&filter[fungible_ids]=,&filter[min_mined_at]=&filter[max_mined_at]=&filter[trash]=no_filter&filter[fungible_implementations]=,", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "transactions", "" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Pagination parameters", "key": "page[after]", "value": "" }, { "description": "Pagination parameters", "key": "page[size]", "value": "100" }, { "description": "Query for a full-text search.", "key": "filter[search_query]", "value": "" }, { "description": "Return only transactions with specified types (comma-separated list). See the operation type schema for the full list of values.", "key": "filter[operation_types]", "value": "delegate,revoke" }, { "description": "Return only transactions that contain specified asset types (comma-separated list).", "key": "filter[asset_types]", "value": "fungible,fungible" }, { "description": "Return only transactions from specified chains (comma-separated list). You can find available chain ids in chain endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Return only transactions with fungibles with specified ids (comma-separated list).", "key": "filter[fungible_ids]", "value": "," }, { "description": "Return only transactions since specific date. Timestamp in milliseconds.", "key": "filter[min_mined_at]", "value": "" }, { "description": "Return only transactions until specific date. Timestamp in milliseconds.", "key": "filter[max_mined_at]", "value": "" }, { "description": "Filter transactions based on the `is_trash` flag. If no flag is specified, then `no_filter` is applied.", "key": "filter[trash]", "value": "no_filter" }, { "description": "Specify implementations of fungible tokens as a comma-separated list of `chain:address` pairs.\n\nExample format: `ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,polygon:0x123456789abcdef123456789abcdef123456789`\n\nEach item consists of a blockchain `chain_id` and an `address`, separated by a colon (`:`). Multiple pairs can be provided using commas (`,`).\n", "key": "filter[fungible_implementations]", "value": "," } ], "variable": [ { "id": "43255964-7d38-44e7-93b1-4a376d084194", "key": "address", "value": "", "description": "(Required) Address of the wallet. Must be a valid EVM or Solana address. Returns 400 if the address is not tracked by Zerion." } ] }, "description": "This endpoint returns a list of transactions associated with the wallet.\n\nThis endpoint supports testnets. To get data for testnets use `X-Env` header.\n\n**Temporary limitations for Solana addresses:**\n- Doesn't support NFT transactions\n\n> NOTE: This endpoint supports a lot of filters, sorting, and pagination parameters. Make sure that your request URL length is safe for your platform. Usually, 2000 characters are the safe limit in virtually any combination of client and server software.\n\n> NOTE: Consider all IDs as abstract strings, without making any assumptions about their format or relying on such assumptions. There is a non-zero probability that IDs may change in the future, and this should not result in any breaking changes.\n" }, "response": [ { "id": "a015132d-8535-4680-a315-861efc004d1b", "name": "Response for requested list of transactions", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/transactions/?currency=usd&page[after]=&page[size]=100&filter[search_query]=&filter[operation_types]=delegate,revoke&filter[asset_types]=fungible,fungible&filter[chain_ids]=,&filter[fungible_ids]=,&filter[min_mined_at]=&filter[max_mined_at]=&filter[trash]=no_filter&filter[fungible_implementations]=,", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "transactions", "" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Pagination parameters", "key": "page[after]", "value": "" }, { "description": "Pagination parameters", "key": "page[size]", "value": "100" }, { "description": "Query for a full-text search.", "key": "filter[search_query]", "value": "" }, { "description": "Return only transactions with specified types (comma-separated list). See the operation type schema for the full list of values.", "key": "filter[operation_types]", "value": "delegate,revoke" }, { "description": "Return only transactions that contain specified asset types (comma-separated list).", "key": "filter[asset_types]", "value": "fungible,fungible" }, { "description": "Return only transactions from specified chains (comma-separated list). You can find available chain ids in chain endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Return only transactions with fungibles with specified ids (comma-separated list).", "key": "filter[fungible_ids]", "value": "," }, { "description": "Return only transactions since specific date. Timestamp in milliseconds.", "key": "filter[min_mined_at]", "value": "" }, { "description": "Return only transactions until specific date. Timestamp in milliseconds.", "key": "filter[max_mined_at]", "value": "" }, { "description": "Filter transactions based on the `is_trash` flag. If no flag is specified, then `no_filter` is applied.", "key": "filter[trash]", "value": "no_filter" }, { "description": "Specify implementations of fungible tokens as a comma-separated list of `chain:address` pairs.\n\nExample format: `ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,polygon:0x123456789abcdef123456789abcdef123456789`\n\nEach item consists of a blockchain `chain_id` and an `address`, separated by a colon (`:`). Multiple pairs can be provided using commas (`,`).\n", "key": "filter[fungible_implementations]", "value": "," } ], "variable": [ { "key": "address" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": \"\",\n \"next\": \"\"\n },\n \"data\": [\n {\n \"type\": \"transactions\",\n \"id\": \"\",\n \"attributes\": {\n \"operation_type\": \"receive\",\n \"hash\": \"\",\n \"mined_at_block\": \"\",\n \"mined_at\": \"\",\n \"sent_from\": \"\",\n \"sent_to\": \"\",\n \"status\": \"confirmed\",\n \"nonce\": \"\",\n \"fee\": {\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"price\": \"\",\n \"value\": \"\"\n },\n \"transfers\": [\n {\n \"direction\": \"out\",\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"value\": \"\",\n \"price\": \"\",\n \"sender\": \"\",\n \"recipient\": \"\",\n \"act_id\": \"\",\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"nft_info\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"name\": \"\",\n \"interface\": \"erc1155\",\n \"flags\": {\n \"is_spam\": \"\"\n },\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n },\n {\n \"direction\": \"out\",\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"value\": \"\",\n \"price\": \"\",\n \"sender\": \"\",\n \"recipient\": \"\",\n \"act_id\": \"\",\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"nft_info\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"name\": \"\",\n \"interface\": \"erc721\",\n \"flags\": {\n \"is_spam\": \"\"\n },\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n }\n ],\n \"approvals\": [\n {\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"sender\": \"\",\n \"act_id\": \"\",\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"nft_info\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"name\": \"\",\n \"interface\": \"erc1155\",\n \"flags\": {\n \"is_spam\": \"\"\n },\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n },\n {\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"sender\": \"\",\n \"act_id\": \"\",\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"nft_info\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"name\": \"\",\n \"interface\": \"erc1155\",\n \"flags\": {\n \"is_spam\": \"\"\n },\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n }\n ],\n \"address\": \"\",\n \"refund\": {\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"value\": \"\",\n \"price\": \"\"\n },\n \"collection_approvals\": [\n {\n \"cancelled\": \"\",\n \"spender\": \"\",\n \"act_id\": \"\",\n \"collection_info\": {\n \"id\": \"\",\n \"name\": \"\",\n \"icon_url\": \"\"\n }\n },\n {\n \"cancelled\": \"\",\n \"spender\": \"\",\n \"act_id\": \"\",\n \"collection_info\": {\n \"id\": \"\",\n \"name\": \"\",\n \"icon_url\": \"\"\n }\n }\n ],\n \"delegations\": [\n {\n \"address\": \"\",\n \"act_id\": \"\",\n \"chain_id\": \"\"\n },\n {\n \"address\": \"\",\n \"act_id\": \"\",\n \"chain_id\": \"\"\n }\n ],\n \"application_metadata\": {\n \"contract_address\": \"\",\n \"name\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"method\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n },\n \"flags\": {\n \"is_trash\": \"\"\n },\n \"acts\": [\n {\n \"id\": \"\",\n \"type\": \"delegate\",\n \"fee_kind\": \"ui\",\n \"sent_from\": \"\",\n \"application_metadata\": {\n \"contract_address\": \"\",\n \"name\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"method\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n },\n {\n \"id\": \"\",\n \"type\": \"receive\",\n \"fee_kind\": \"ui\",\n \"sent_from\": \"\",\n \"application_metadata\": {\n \"contract_address\": \"\",\n \"name\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"method\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n }\n ],\n \"paymaster\": \"\"\n },\n \"relationships\": {\n \"chain\": {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"dapp\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n }\n },\n {\n \"type\": \"transactions\",\n \"id\": \"\",\n \"attributes\": {\n \"operation_type\": \"delegate\",\n \"hash\": \"\",\n \"mined_at_block\": \"\",\n \"mined_at\": \"\",\n \"sent_from\": \"\",\n \"sent_to\": \"\",\n \"status\": \"pending\",\n \"nonce\": \"\",\n \"fee\": {\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"price\": \"\",\n \"value\": \"\"\n },\n \"transfers\": [\n {\n \"direction\": \"self\",\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"value\": \"\",\n \"price\": \"\",\n \"sender\": \"\",\n \"recipient\": \"\",\n \"act_id\": \"\",\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"nft_info\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"name\": \"\",\n \"interface\": \"erc1155\",\n \"flags\": {\n \"is_spam\": \"\"\n },\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n },\n {\n \"direction\": \"in\",\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"value\": \"\",\n \"price\": \"\",\n \"sender\": \"\",\n \"recipient\": \"\",\n \"act_id\": \"\",\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"nft_info\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"name\": \"\",\n \"interface\": \"erc1155\",\n \"flags\": {\n \"is_spam\": \"\"\n },\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n }\n ],\n \"approvals\": [\n {\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"sender\": \"\",\n \"act_id\": \"\",\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"nft_info\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"name\": \"\",\n \"interface\": \"erc1155\",\n \"flags\": {\n \"is_spam\": \"\"\n },\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n },\n {\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"sender\": \"\",\n \"act_id\": \"\",\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"nft_info\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"name\": \"\",\n \"interface\": \"erc721\",\n \"flags\": {\n \"is_spam\": \"\"\n },\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n }\n ],\n \"address\": \"\",\n \"refund\": {\n \"fungible_info\": {\n \"name\": \"\",\n \"symbol\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"flags\": {\n \"verified\": \"\"\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"decimals\": \"\",\n \"address\": \"\"\n }\n ],\n \"id\": \"\",\n \"description\": \"\",\n \"market_data\": {\n \"price\": \"\",\n \"total_supply\": \"\",\n \"circulating_supply\": \"\",\n \"fully_diluted_valuation\": \"\",\n \"market_cap\": \"\",\n \"changes\": {\n \"percent_1d\": \"\",\n \"percent_30d\": \"\",\n \"percent_90d\": \"\",\n \"percent_365d\": \"\"\n },\n \"trading_volumes\": {\n \"volume_1d\": \"\"\n }\n }\n },\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n },\n \"value\": \"\",\n \"price\": \"\"\n },\n \"collection_approvals\": [\n {\n \"cancelled\": \"\",\n \"spender\": \"\",\n \"act_id\": \"\",\n \"collection_info\": {\n \"id\": \"\",\n \"name\": \"\",\n \"icon_url\": \"\"\n }\n },\n {\n \"cancelled\": \"\",\n \"spender\": \"\",\n \"act_id\": \"\",\n \"collection_info\": {\n \"id\": \"\",\n \"name\": \"\",\n \"icon_url\": \"\"\n }\n }\n ],\n \"delegations\": [\n {\n \"address\": \"\",\n \"act_id\": \"\",\n \"chain_id\": \"\"\n },\n {\n \"address\": \"\",\n \"act_id\": \"\",\n \"chain_id\": \"\"\n }\n ],\n \"application_metadata\": {\n \"contract_address\": \"\",\n \"name\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"method\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n },\n \"flags\": {\n \"is_trash\": \"\"\n },\n \"acts\": [\n {\n \"id\": \"\",\n \"type\": \"bid\",\n \"fee_kind\": \"jito\",\n \"sent_from\": \"\",\n \"application_metadata\": {\n \"contract_address\": \"\",\n \"name\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"method\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n },\n {\n \"id\": \"\",\n \"type\": \"fee\",\n \"fee_kind\": \"ui\",\n \"sent_from\": \"\",\n \"application_metadata\": {\n \"contract_address\": \"\",\n \"name\": \"\",\n \"icon\": {\n \"url\": \"\"\n },\n \"method\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n }\n ],\n \"paymaster\": \"\"\n },\n \"relationships\": {\n \"chain\": {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"dapp\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n }\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-a015132d-8535-4680-a315-861efc004d1b" }, { "id": "789e8c32-b04c-4cfc-b29d-8e028b001a7e", "name": "Parameters are malformed", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/transactions/?currency=usd&page[after]=&page[size]=100&filter[search_query]=&filter[operation_types]=delegate,revoke&filter[asset_types]=fungible,fungible&filter[chain_ids]=,&filter[fungible_ids]=,&filter[min_mined_at]=&filter[max_mined_at]=&filter[trash]=no_filter&filter[fungible_implementations]=,", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "transactions", "" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Pagination parameters", "key": "page[after]", "value": "" }, { "description": "Pagination parameters", "key": "page[size]", "value": "100" }, { "description": "Query for a full-text search.", "key": "filter[search_query]", "value": "" }, { "description": "Return only transactions with specified types (comma-separated list). See the operation type schema for the full list of values.", "key": "filter[operation_types]", "value": "delegate,revoke" }, { "description": "Return only transactions that contain specified asset types (comma-separated list).", "key": "filter[asset_types]", "value": "fungible,fungible" }, { "description": "Return only transactions from specified chains (comma-separated list). You can find available chain ids in chain endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Return only transactions with fungibles with specified ids (comma-separated list).", "key": "filter[fungible_ids]", "value": "," }, { "description": "Return only transactions since specific date. Timestamp in milliseconds.", "key": "filter[min_mined_at]", "value": "" }, { "description": "Return only transactions until specific date. Timestamp in milliseconds.", "key": "filter[max_mined_at]", "value": "" }, { "description": "Filter transactions based on the `is_trash` flag. If no flag is specified, then `no_filter` is applied.", "key": "filter[trash]", "value": "no_filter" }, { "description": "Specify implementations of fungible tokens as a comma-separated list of `chain:address` pairs.\n\nExample format: `ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,polygon:0x123456789abcdef123456789abcdef123456789`\n\nEach item consists of a blockchain `chain_id` and an `address`, separated by a colon (`:`). Multiple pairs can be provided using commas (`,`).\n", "key": "filter[fungible_implementations]", "value": "," } ], "variable": [ { "key": "address" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-789e8c32-b04c-4cfc-b29d-8e028b001a7e" }, { "id": "653fccc5-f72a-46d3-aae7-28dd7f6d37ce", "name": "Unathenticated request", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/transactions/?currency=usd&page[after]=&page[size]=100&filter[search_query]=&filter[operation_types]=delegate,revoke&filter[asset_types]=fungible,fungible&filter[chain_ids]=,&filter[fungible_ids]=,&filter[min_mined_at]=&filter[max_mined_at]=&filter[trash]=no_filter&filter[fungible_implementations]=,", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "transactions", "" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Pagination parameters", "key": "page[after]", "value": "" }, { "description": "Pagination parameters", "key": "page[size]", "value": "100" }, { "description": "Query for a full-text search.", "key": "filter[search_query]", "value": "" }, { "description": "Return only transactions with specified types (comma-separated list). See the operation type schema for the full list of values.", "key": "filter[operation_types]", "value": "delegate,revoke" }, { "description": "Return only transactions that contain specified asset types (comma-separated list).", "key": "filter[asset_types]", "value": "fungible,fungible" }, { "description": "Return only transactions from specified chains (comma-separated list). You can find available chain ids in chain endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Return only transactions with fungibles with specified ids (comma-separated list).", "key": "filter[fungible_ids]", "value": "," }, { "description": "Return only transactions since specific date. Timestamp in milliseconds.", "key": "filter[min_mined_at]", "value": "" }, { "description": "Return only transactions until specific date. Timestamp in milliseconds.", "key": "filter[max_mined_at]", "value": "" }, { "description": "Filter transactions based on the `is_trash` flag. If no flag is specified, then `no_filter` is applied.", "key": "filter[trash]", "value": "no_filter" }, { "description": "Specify implementations of fungible tokens as a comma-separated list of `chain:address` pairs.\n\nExample format: `ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,polygon:0x123456789abcdef123456789abcdef123456789`\n\nEach item consists of a blockchain `chain_id` and an `address`, separated by a colon (`:`). Multiple pairs can be provided using commas (`,`).\n", "key": "filter[fungible_implementations]", "value": "," } ], "variable": [ { "key": "address" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-653fccc5-f72a-46d3-aae7-28dd7f6d37ce" }, { "id": "6bbf710c-99ba-4b77-a3ac-4b680d3b15e4", "name": "Too many requests error", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/transactions/?currency=usd&page[after]=&page[size]=100&filter[search_query]=&filter[operation_types]=delegate,revoke&filter[asset_types]=fungible,fungible&filter[chain_ids]=,&filter[fungible_ids]=,&filter[min_mined_at]=&filter[max_mined_at]=&filter[trash]=no_filter&filter[fungible_implementations]=,", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "transactions", "" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Pagination parameters", "key": "page[after]", "value": "" }, { "description": "Pagination parameters", "key": "page[size]", "value": "100" }, { "description": "Query for a full-text search.", "key": "filter[search_query]", "value": "" }, { "description": "Return only transactions with specified types (comma-separated list). See the operation type schema for the full list of values.", "key": "filter[operation_types]", "value": "delegate,revoke" }, { "description": "Return only transactions that contain specified asset types (comma-separated list).", "key": "filter[asset_types]", "value": "fungible,fungible" }, { "description": "Return only transactions from specified chains (comma-separated list). You can find available chain ids in chain endpoints.", "key": "filter[chain_ids]", "value": "," }, { "description": "Return only transactions with fungibles with specified ids (comma-separated list).", "key": "filter[fungible_ids]", "value": "," }, { "description": "Return only transactions since specific date. Timestamp in milliseconds.", "key": "filter[min_mined_at]", "value": "" }, { "description": "Return only transactions until specific date. Timestamp in milliseconds.", "key": "filter[max_mined_at]", "value": "" }, { "description": "Filter transactions based on the `is_trash` flag. If no flag is specified, then `no_filter` is applied.", "key": "filter[trash]", "value": "no_filter" }, { "description": "Specify implementations of fungible tokens as a comma-separated list of `chain:address` pairs.\n\nExample format: `ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,polygon:0x123456789abcdef123456789abcdef123456789`\n\nEach item consists of a blockchain `chain_id` and an `address`, separated by a colon (`:`). Multiple pairs can be provided using commas (`,`).\n", "key": "filter[fungible_implementations]", "value": "," } ], "variable": [ { "key": "address" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-6bbf710c-99ba-4b77-a3ac-4b680d3b15e4" } ], "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-80791e43-a7d9-45e4-915b-d74fcd02b0b6" } ], "id": "9ef62dc5-5922-4276-9d11-216aefae5dbe", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-9ef62dc5-5922-4276-9d11-216aefae5dbe" }, { "name": "nft-positions", "item": [ { "name": "Get wallet NFT positions", "id": "248a4013-c1d6-4fd8-89f1-096dfc640a02", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-positions/?filter[chain_ids]=,&filter[collections_ids]=,&sort=-created_at&include=nft_collections,nfts¤cy=usd&page[after]=&page[size]=50", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-positions", "" ], "query": [ { "description": "Keep only positions from the specified chains (comma-separated list). Available chains IDs can be found in chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions from collections with specified IDs (comma-separated list). The IDs are returned inside the 'collection' field of each NFT.", "key": "filter[collections_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-created_at" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nfts" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Pagination parameters", "key": "page[after]", "value": "" }, { "description": "Pagination parameters", "key": "page[size]", "value": "50" } ], "variable": [ { "id": "16657e3c-8016-4582-acf1-91e499f2bb69", "key": "address", "value": "0x3eC01F58C55805DeFD84D7233aEdECEf0b58896C", "description": "(Required) The web3 wallet address. Must be a valid EVM or Solana address. Returns 400 if the address is not tracked by Zerion." } ] }, "description": "This endpoint returns a list of the NFT positions held by a specific wallet.\n\nThis endpoint supports testnets. To get data for testnets use `X-Env` header.\n\nIf the wallet address has not been previously added, this endpoint may return a `202` status code. This indicates that the wallet's positions are not yet available, but will be in the near future. In this case, the client should periodically request this endpoint until a `200` status code is returned.\n\n> NOTE: It is important to stop retrying after a reasonable period of time. If a `200` status code is not returned within 2 minutes, it is likely that an unexpected error has occurred and the client should stop polling.\n\n> NOTE: This endpoint provides support for filters, sorting, and pagination parameters. Ensure that the length of the request URL falls within a safe range for your platform. Typically, a length of 2000 characters is a safe limit for most combinations of client and server software.\n\n> NOTE: Consider all IDs as abstract strings, without making any assumptions about their format or relying on such assumptions. There is a non-zero probability that IDs may change in the future, and this should not result in any breaking changes.\n" }, "response": [ { "id": "954b963c-b6c2-4d28-bfac-57fb13323e00", "name": "Response for requested list of NFT positions.", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-positions/?filter[chain_ids]=,&filter[collections_ids]=,&sort=-created_at&include=nft_collections,nfts¤cy=usd&page[after]=&page[size]=50", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-positions", "" ], "query": [ { "description": "Keep only positions from the specified chains (comma-separated list). Available chains IDs can be found in chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions from collections with specified IDs (comma-separated list). The IDs are returned inside the 'collection' field of each NFT.", "key": "filter[collections_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-created_at" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nfts" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Pagination parameters", "key": "page[after]", "value": "" }, { "description": "Pagination parameters", "key": "page[size]", "value": "50" } ], "variable": [ { "key": "address" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": \"\"\n },\n \"data\": [\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"changed_at\": \"\",\n \"amount\": \"\",\n \"price\": \"\",\n \"value\": \"\",\n \"nft_info\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"name\": \"\",\n \"interface\": \"erc1155\",\n \"flags\": {\n \"is_spam\": \"\"\n },\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n },\n \"collection_info\": {\n \"name\": \"\",\n \"description\": \"\",\n \"content\": {\n \"icon\": {\n \"url\": \"\"\n },\n \"banner\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n },\n \"relationships\": {\n \"chain\": {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"nft_collection\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"nft\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n },\n \"included\": [\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"interface\": \"erc721\",\n \"metadata\": {\n \"name\": \"\",\n \"description\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n },\n \"attributes\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n },\n \"market_data\": {\n \"prices\": {\n \"floor\": \"\"\n },\n \"last_sale\": {\n \"price\": \"\",\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n }\n }\n },\n \"external_links\": [\n {\n \"url\": \"\",\n \"type\": \"\",\n \"name\": \"\"\n },\n {\n \"url\": \"\",\n \"type\": \"\",\n \"name\": \"\"\n }\n ],\n \"flags\": {\n \"is_spam\": \"\"\n }\n },\n \"relationships\": {\n \"chain\": {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"nft_collection\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n }\n },\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"interface\": \"erc721\",\n \"metadata\": {\n \"name\": \"\",\n \"description\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n },\n \"attributes\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n },\n \"market_data\": {\n \"prices\": {\n \"floor\": \"\"\n },\n \"last_sale\": {\n \"price\": \"\",\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n }\n }\n },\n \"external_links\": [\n {\n \"url\": \"\",\n \"type\": \"\",\n \"name\": \"\"\n },\n {\n \"url\": \"\",\n \"type\": \"\",\n \"name\": \"\"\n }\n ],\n \"flags\": {\n \"is_spam\": \"\"\n }\n },\n \"relationships\": {\n \"chain\": {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"nft_collection\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n }\n }\n ]\n },\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"changed_at\": \"\",\n \"amount\": \"\",\n \"price\": \"\",\n \"value\": \"\",\n \"nft_info\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"name\": \"\",\n \"interface\": \"erc721\",\n \"flags\": {\n \"is_spam\": \"\"\n },\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n },\n \"collection_info\": {\n \"name\": \"\",\n \"description\": \"\",\n \"content\": {\n \"icon\": {\n \"url\": \"\"\n },\n \"banner\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n },\n \"relationships\": {\n \"chain\": {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"nft_collection\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"nft\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n },\n \"included\": [\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"interface\": \"erc1155\",\n \"metadata\": {\n \"name\": \"\",\n \"description\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n },\n \"attributes\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n },\n \"market_data\": {\n \"prices\": {\n \"floor\": \"\"\n },\n \"last_sale\": {\n \"price\": \"\",\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n }\n }\n },\n \"external_links\": [\n {\n \"url\": \"\",\n \"type\": \"\",\n \"name\": \"\"\n },\n {\n \"url\": \"\",\n \"type\": \"\",\n \"name\": \"\"\n }\n ],\n \"flags\": {\n \"is_spam\": \"\"\n }\n },\n \"relationships\": {\n \"chain\": {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"nft_collection\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n }\n },\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"contract_address\": \"\",\n \"token_id\": \"\",\n \"interface\": \"erc1155\",\n \"metadata\": {\n \"name\": \"\",\n \"description\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"content\": {\n \"preview\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"detail\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"audio\": {\n \"url\": \"\",\n \"content_type\": \"\"\n },\n \"video\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n },\n \"attributes\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n },\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ]\n },\n \"market_data\": {\n \"prices\": {\n \"floor\": \"\"\n },\n \"last_sale\": {\n \"price\": \"\",\n \"quantity\": {\n \"int\": \"\",\n \"decimals\": \"\",\n \"float\": \"\",\n \"numeric\": \"\"\n }\n }\n },\n \"external_links\": [\n {\n \"url\": \"\",\n \"type\": \"\",\n \"name\": \"\"\n },\n {\n \"url\": \"\",\n \"type\": \"\",\n \"name\": \"\"\n }\n ],\n \"flags\": {\n \"is_spam\": \"\"\n }\n },\n \"relationships\": {\n \"chain\": {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n \"nft_collection\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n }\n }\n ]\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-954b963c-b6c2-4d28-bfac-57fb13323e00" }, { "id": "aaf381c4-7770-4da5-903d-b9b74be17f5e", "name": "Request accepted, but NFT positions are still being aggregated.", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-positions/?filter[chain_ids]=,&filter[collections_ids]=,&sort=-created_at&include=nft_collections,nfts¤cy=usd&page[after]=&page[size]=50", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-positions", "" ], "query": [ { "description": "Keep only positions from the specified chains (comma-separated list). Available chains IDs can be found in chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions from collections with specified IDs (comma-separated list). The IDs are returned inside the 'collection' field of each NFT.", "key": "filter[collections_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-created_at" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nfts" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Pagination parameters", "key": "page[after]", "value": "" }, { "description": "Pagination parameters", "key": "page[size]", "value": "50" } ], "variable": [ { "key": "address" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": \"\"\n },\n \"data\": \"\"\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-aaf381c4-7770-4da5-903d-b9b74be17f5e" }, { "id": "efc482ca-6c3c-467e-8e19-00a832a11cbc", "name": "Parameters are malformed", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-positions/?filter[chain_ids]=,&filter[collections_ids]=,&sort=-created_at&include=nft_collections,nfts¤cy=usd&page[after]=&page[size]=50", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-positions", "" ], "query": [ { "description": "Keep only positions from the specified chains (comma-separated list). Available chains IDs can be found in chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions from collections with specified IDs (comma-separated list). The IDs are returned inside the 'collection' field of each NFT.", "key": "filter[collections_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-created_at" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nfts" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Pagination parameters", "key": "page[after]", "value": "" }, { "description": "Pagination parameters", "key": "page[size]", "value": "50" } ], "variable": [ { "key": "address" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-efc482ca-6c3c-467e-8e19-00a832a11cbc" }, { "id": "0513eccc-5ad0-494e-9b18-8e6483cc60ac", "name": "Unathenticated request", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-positions/?filter[chain_ids]=,&filter[collections_ids]=,&sort=-created_at&include=nft_collections,nfts¤cy=usd&page[after]=&page[size]=50", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-positions", "" ], "query": [ { "description": "Keep only positions from the specified chains (comma-separated list). Available chains IDs can be found in chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions from collections with specified IDs (comma-separated list). The IDs are returned inside the 'collection' field of each NFT.", "key": "filter[collections_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-created_at" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nfts" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Pagination parameters", "key": "page[after]", "value": "" }, { "description": "Pagination parameters", "key": "page[size]", "value": "50" } ], "variable": [ { "key": "address" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-0513eccc-5ad0-494e-9b18-8e6483cc60ac" }, { "id": "6606cb02-4f81-4739-b103-bd30e78bfd70", "name": "Too many requests error", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-positions/?filter[chain_ids]=,&filter[collections_ids]=,&sort=-created_at&include=nft_collections,nfts¤cy=usd&page[after]=&page[size]=50", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-positions", "" ], "query": [ { "description": "Keep only positions from the specified chains (comma-separated list). Available chains IDs can be found in chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "Keep only positions from collections with specified IDs (comma-separated list). The IDs are returned inside the 'collection' field of each NFT.", "key": "filter[collections_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-created_at" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nfts" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Pagination parameters", "key": "page[after]", "value": "" }, { "description": "Pagination parameters", "key": "page[size]", "value": "50" } ], "variable": [ { "key": "address" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-6606cb02-4f81-4739-b103-bd30e78bfd70" } ], "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-248a4013-c1d6-4fd8-89f1-096dfc640a02" } ], "id": "7ce2f675-0cad-49f7-8a75-a6de036c2df9", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-7ce2f675-0cad-49f7-8a75-a6de036c2df9" }, { "name": "nft-collections", "item": [ { "name": "Get wallet NFT collections", "id": "f092615e-f470-44fa-bd06-323dfde73d9f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-collections/?filter[chain_ids]=,&sort=-total_floor_price¤cy=usd&include=nft_collections,nft_collections", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-collections", "" ], "query": [ { "description": "Keep only collections from the specified chains (comma-separated list). Available chain IDs can be found in the chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-total_floor_price" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nft_collections" } ], "variable": [ { "id": "57846857-1315-4768-ba49-c637ccf7937e", "key": "address", "value": "0x3eC01F58C55805DeFD84D7233aEdECEf0b58896C", "description": "(Required) The web3 wallet address. Must be a valid EVM or Solana address. Returns 400 if the address is not tracked by Zerion." } ] }, "description": "This endpoint returns a list of the NFT collections held by a specific wallet.\n\nThis endpoint supports testnets. To get data for testnets use `X-Env` header.\n\nIf the wallet address has not been previously added, this endpoint may return a `202` status code. This indicates that the wallet's collections are not yet available, but will be in the near future. In this case, the client should periodically request this endpoint until a `200` status code is returned.\n\n> NOTE: It is important to stop retrying after a reasonable period of time. If a `200` status code is not returned within 2 minutes, it is likely that an unexpected error has occurred, and the client should stop polling.\n\n> NOTE: This endpoint provides support for filters, sorting. Ensure that the length of the request URL falls within a safe range for your platform. Typically, a length of 2000 characters is a safe limit for most combinations of client and server software.\n\n> NOTE: Consider all IDs as abstract strings, without making any assumptions about their format or relying on such assumptions. There is a non-zero probability that IDs may change in the future, and this should not result in any breaking changes.\n" }, "response": [ { "id": "bcbb91c0-caac-4ada-843d-592199b6a605", "name": "Response for requested list of NFT collections.", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-collections/?filter[chain_ids]=,&sort=-total_floor_price¤cy=usd&include=nft_collections,nft_collections", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-collections", "" ], "query": [ { "description": "Keep only collections from the specified chains (comma-separated list). Available chain IDs can be found in the chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-total_floor_price" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nft_collections" } ], "variable": [ { "key": "address" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": \"\"\n },\n \"data\": [\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"nfts_count\": \"\",\n \"total_floor_price\": \"\",\n \"min_changed_at\": \"\",\n \"max_changed_at\": \"\",\n \"collection_info\": {\n \"name\": \"\",\n \"description\": \"\",\n \"content\": {\n \"icon\": {\n \"url\": \"\"\n },\n \"banner\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n },\n \"relationships\": {\n \"chains\": [\n {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n ],\n \"nft_collection\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n },\n \"included\": [\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"metadata\": {\n \"name\": \"\",\n \"description\": \"\",\n \"content\": {\n \"icon\": {\n \"url\": \"\"\n },\n \"banner\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n },\n \"payment_token_symbol\": \"\"\n },\n \"market_data\": {\n \"prices\": {\n \"floor\": \"\"\n }\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"address\": \"\"\n }\n ]\n }\n },\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"metadata\": {\n \"name\": \"\",\n \"description\": \"\",\n \"content\": {\n \"icon\": {\n \"url\": \"\"\n },\n \"banner\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n },\n \"payment_token_symbol\": \"\"\n },\n \"market_data\": {\n \"prices\": {\n \"floor\": \"\"\n }\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"address\": \"\"\n }\n ]\n }\n }\n ]\n },\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"nfts_count\": \"\",\n \"total_floor_price\": \"\",\n \"min_changed_at\": \"\",\n \"max_changed_at\": \"\",\n \"collection_info\": {\n \"name\": \"\",\n \"description\": \"\",\n \"content\": {\n \"icon\": {\n \"url\": \"\"\n },\n \"banner\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n }\n }\n },\n \"relationships\": {\n \"chains\": [\n {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n },\n {\n \"links\": {\n \"related\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n ],\n \"nft_collection\": {\n \"data\": {\n \"type\": \"\",\n \"id\": \"\"\n }\n }\n },\n \"included\": [\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"metadata\": {\n \"name\": \"\",\n \"description\": \"\",\n \"content\": {\n \"icon\": {\n \"url\": \"\"\n },\n \"banner\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n },\n \"payment_token_symbol\": \"\"\n },\n \"market_data\": {\n \"prices\": {\n \"floor\": \"\"\n }\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"address\": \"\"\n }\n ]\n }\n },\n {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"metadata\": {\n \"name\": \"\",\n \"description\": \"\",\n \"content\": {\n \"icon\": {\n \"url\": \"\"\n },\n \"banner\": {\n \"url\": \"\",\n \"content_type\": \"\"\n }\n },\n \"payment_token_symbol\": \"\"\n },\n \"market_data\": {\n \"prices\": {\n \"floor\": \"\"\n }\n },\n \"implementations\": [\n {\n \"chain_id\": \"\",\n \"address\": \"\"\n },\n {\n \"chain_id\": \"\",\n \"address\": \"\"\n }\n ]\n }\n }\n ]\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-bcbb91c0-caac-4ada-843d-592199b6a605" }, { "id": "4e464c1a-211a-47ae-858d-90de116ebbea", "name": "Request accepted, but NFT collections held by the wallet are still being aggregated.", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-collections/?filter[chain_ids]=,&sort=-total_floor_price¤cy=usd&include=nft_collections,nft_collections", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-collections", "" ], "query": [ { "description": "Keep only collections from the specified chains (comma-separated list). Available chain IDs can be found in the chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-total_floor_price" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nft_collections" } ], "variable": [ { "key": "address" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": \"\"\n },\n \"data\": \"\"\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-4e464c1a-211a-47ae-858d-90de116ebbea" }, { "id": "6d161230-f3a2-413a-a62d-a71b6251c834", "name": "Parameters are malformed", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-collections/?filter[chain_ids]=,&sort=-total_floor_price¤cy=usd&include=nft_collections,nft_collections", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-collections", "" ], "query": [ { "description": "Keep only collections from the specified chains (comma-separated list). Available chain IDs can be found in the chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-total_floor_price" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nft_collections" } ], "variable": [ { "key": "address" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-6d161230-f3a2-413a-a62d-a71b6251c834" }, { "id": "97448bb4-458c-46fb-a307-d3abf48bf65c", "name": "Unathenticated request", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-collections/?filter[chain_ids]=,&sort=-total_floor_price¤cy=usd&include=nft_collections,nft_collections", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-collections", "" ], "query": [ { "description": "Keep only collections from the specified chains (comma-separated list). Available chain IDs can be found in the chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-total_floor_price" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nft_collections" } ], "variable": [ { "key": "address" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-97448bb4-458c-46fb-a307-d3abf48bf65c" }, { "id": "034a17b8-5e06-4060-9d31-5aa6391a770f", "name": "Too many requests error", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-collections/?filter[chain_ids]=,&sort=-total_floor_price¤cy=usd&include=nft_collections,nft_collections", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-collections", "" ], "query": [ { "description": "Keep only collections from the specified chains (comma-separated list). Available chain IDs can be found in the chains endpoint.", "key": "filter[chain_ids]", "value": "," }, { "description": "The order of NFTs in the result.", "key": "sort", "value": "-total_floor_price" }, { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" }, { "description": "Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.", "key": "include", "value": "nft_collections,nft_collections" } ], "variable": [ { "key": "address" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-034a17b8-5e06-4060-9d31-5aa6391a770f" } ], "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-f092615e-f470-44fa-bd06-323dfde73d9f" } ], "id": "89835fda-a7db-4ae6-9057-41e2d0f08695", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-89835fda-a7db-4ae6-9057-41e2d0f08695" }, { "name": "nft-portfolio", "item": [ { "name": "Get wallet NFT portfolio", "id": "c5e7a181-7e5d-4146-9736-2d812ca8444b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-portfolio?currency=usd", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-portfolio" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" } ], "variable": [ { "id": "2526bc41-a89d-4d71-8201-76080de1e63d", "key": "address", "value": "0x3eC01F58C55805DeFD84D7233aEdECEf0b58896C", "description": "(Required) The web3 wallet address. Must be a valid EVM or Solana address. Returns 400 if the address is not tracked by Zerion." } ] }, "description": "This endpoint returns the NFT portfolio overview of a web3 wallet.\n\nThis endpoint supports testnets. To get data for testnets use `X-Env` header.\n\nIf the address was not added before it is possible that this endpoint will return `202` status. It means that portfolio for the wallet is not prepared yet, but will be available soon. In that case the client have to request this endpoint periodically, while `200` status wasn't returned.\n\n> NOTE: Don't forget to stop retries after some reasonable period of time. If the `200` status is not returned within 2 minutes it most probably means that some unexpected error occurred and the client should stop the polling.\n" }, "response": [ { "id": "45c042c7-9cb9-4c81-b2d2-1a8464d0864b", "name": "Response for requested wallet's portfolio", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-portfolio?currency=usd", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-portfolio" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" } ], "variable": [ { "key": "address" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": \"\"\n },\n \"data\": {\n \"type\": \"\",\n \"id\": \"\",\n \"attributes\": {\n \"positions_distribution_by_chain\": {\n \"arbitrum\": \"\",\n \"aurora\": \"\",\n \"avalanche\": \"\",\n \"binance-smart-chain\": \"\",\n \"ethereum\": \"\",\n \"fantom\": \"\",\n \"loopring\": \"\",\n \"optimism\": \"\",\n \"polygon\": \"\",\n \"solana\": \"\",\n \"xdai\": \"\"\n }\n }\n }\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-45c042c7-9cb9-4c81-b2d2-1a8464d0864b" }, { "id": "4aca5aeb-7544-4ec3-bc37-895d13c512ce", "name": "Request accepted, but nft portfolio is still being aggregated", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-portfolio?currency=usd", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-portfolio" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" } ], "variable": [ { "key": "address" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": \"\"\n },\n \"data\": {}\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-4aca5aeb-7544-4ec3-bc37-895d13c512ce" }, { "id": "6d239b22-8eb3-408c-b3a4-a9f8daea9169", "name": "Parameters are malformed", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-portfolio?currency=usd", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-portfolio" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" } ], "variable": [ { "key": "address" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-6d239b22-8eb3-408c-b3a4-a9f8daea9169" }, { "id": "153e0e5e-0fc8-4ee4-9a0e-fa2f80fa261a", "name": "Unathenticated request", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-portfolio?currency=usd", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-portfolio" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" } ], "variable": [ { "key": "address" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-153e0e5e-0fc8-4ee4-9a0e-fa2f80fa261a" }, { "id": "89ffb2c7-aa7e-4e81-bed1-82c8d1bc998e", "name": "Too many requests error", "originalRequest": { "method": "GET", "header": [ { "description": "Custom header that allows you to get data for testnets.", "key": "X-Env", "value": "testnet" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: basic", "key": "Authorization", "value": "Basic " } ], "url": { "raw": "{{baseUrl}}/v1/wallets/:address/nft-portfolio?currency=usd", "host": [ "{{baseUrl}}" ], "path": [ "v1", "wallets", ":address", "nft-portfolio" ], "query": [ { "description": "Denominated currency value of returned prices", "key": "currency", "value": "usd" } ], "variable": [ { "key": "address" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"title\": \"\",\n \"detail\": \"\"\n },\n {\n \"title\": \"\",\n \"detail\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-89ffb2c7-aa7e-4e81-bed1-82c8d1bc998e" } ], "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-c5e7a181-7e5d-4146-9736-2d812ca8444b" } ], "id": "d0ad46af-fcdd-4e3f-94de-4ea0fedfca3a", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-d0ad46af-fcdd-4e3f-94de-4ea0fedfca3a" } ], "id": "609ca30e-b742-4412-961d-efa5485c6215", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-609ca30e-b742-4412-961d-efa5485c6215" } ], "id": "466223ce-798f-47ec-b063-e60df9aa59ec", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-466223ce-798f-47ec-b063-e60df9aa59ec" } ], "id": "e21c8e0c-31fb-4714-9508-d9b14a7e2d14", "createdAt": "2026-07-28T03:37:53.000Z", "updatedAt": "2026-07-28T03:37:53.000Z", "uid": "35240-e21c8e0c-31fb-4714-9508-d9b14a7e2d14" } ], "auth": { "type": "basic", "basic": [ { "key": "username", "value": "{{basicAuthUsername}}", "type": "string" }, { "key": "password", "value": "{{basicAuthPassword}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.zerion.io" } ] }