Get Portfolio Activity

GET /portfolio/activity/v1

This endpoint returns portfolio activity for a specific wallet address.

Request Params:

wallets required

types

Filter by activity types including nft_sale, nft_transfer, nft_mint, nft_ask, nft_bid, nft_ask_cancel, nft_bid_cancel, token_transfer, bridge, swap and contract_call

limit

continuation

Example Requests:

https://api-abstract-testnet.reservoir.tools/portfolio/activity/v1?wallets=0x1e85f4a50683808801b0a69f9a6bbd492e2e4d30&limit=20

https://api-abstract-testnet.reservoir.tools/portfolio/activity/v1?wallets=0x1e85f4a50683808801b0a69f9a6bbd492e2e4d30&limit=20&types=token_transfer

Example Response:

{
  "activities": [
    {
      "type": "contract_call",
      "fromAddress": "0xf70da97812cb96acdf810712aa562db8dfa3dbef",
      "toAddress": "0xf44444dd1b19d9dc0636f5703123491b3b52eb49",
      "timestamp": "2024-09-23T20:49:29.000Z",
      "data": {
        "gasPrice": "45430126",
        "txHash": "0x1ed5cde740b1b990aa1dd18352a9973ee26d0be9720efb9442c4dde3f7a9c4e9"
      }
    },
    {
			"type": "swap",
			"fromAddress": "0x0fabf63ff612d3103115da09905ae8b744d9e258",
			"toAddress": "0x",
			"timestamp": "2024-10-12T12:08:53.000Z",
			"data": {
				"status": "success",
				"fromToken": {
					"chainId": "10",
					"txHash": "0x6a968aae06cff32bf5c7a4a495cb6258e0095fcfbc54cf5ce418e21b86578015",
					"amount": {
						"raw": "1200000000000000",
						"decimal": "0.0012",
						"usd": "2.944728"
					},
					"token": {
						"contract": "0x0000000000000000000000000000000000000000",
						"name": "Ether",
						"symbol": "ETH",
						"decimals": 18,
						"metadata": {
							"image": "<https://assets.relay.link/icons/1/light.png>"
						}
					}
				},
				"toToken": {
					"chainId": "792703809",
					"txHash": "46nAYBDyFodBFzk7ZXcZtAf56ZbAzEzY14XANvm18AHbkx4FBWnDrvvd3e2FeXJNVU1b37vJ5B94BtC9uD2cKJP7",
					"amount": {
						"raw": "19644319",
						"decimal": "0.019644319",
						"usd": "2.868071"
					},
					"token": {
						"contract": "11111111111111111111111111111111",
						"name": "Solana",
						"symbol": "SOL",
						"decimals": 9,
						"metadata": {
							"image": "<https://upload.wikimedia.org/wikipedia/en/b/b9/Solana_logo.png>"
						}
					}
				}
			}
		},
    {
      "type": "bridge",
      "fromAddress": "0xf44444dd1b19d9dc0636f5703123491b3b52eb49",
      "toAddress": "0xf44444dd1b19d9dc0636f5703123491b3b52eb49",
      "timestamp": "2024-09-23T20:49:26.000Z",
      "data": {
        "status": "success",
        "fromToken": {
          "chainId": "185",
          "txHash": "0x86c4da9ff19fc6788f8fdc5e09786434bdae5517cc42235edb86e763fc7bd15d",
          "amount": {
            "raw": "210000000000000",
            "decimal": "0.00021",
            "usd": "0.561055"
          },
          "token": {
            "contract": "0x0000000000000000000000000000000000000000",
            "name": "Ether",
            "symbol": "ETH",
            "decimals": 18,
            "metadata": {
              "image": "<https://assets.relay.link/icons/1/light.png>"
            }
          }
        },
        "toToken": {
          "chainId": "10",
          "txHash": "0x1ed5cde740b1b990aa1dd18352a9973ee26d0be9720efb9442c4dde3f7a9c4e9",
          "amount": {
            "raw": "207018310873491",
            "decimal": "0.000207018310873491",
            "usd": "0.553089"
          },
          "token": {
            "contract": "0x0000000000000000000000000000000000000000",
            "name": "Ether",
            "symbol": "ETH",
            "decimals": 18,
            "metadata": {
              "image": "<https://assets.relay.link/icons/1/light.png>"
            }
          }
        }
      }
    },
    {
      "type": "nft_mint",
      "fromAddress": "0x0000000000000000000000000000000000000000",
      "toAddress": "0xf44444dd1b19d9dc0636f5703123491b3b52eb49",
      "timestamp": "2023-02-24T08:29:12.000Z",
      "data": {
        "contract": "0x63a9addf2327a0f4b71bcf9bfa757e333e1b7177",
        "nft": {
          "tokenId": "28153",
          "name": "Backed Community NFT #28153",
          "image": "<https://img.reservoir.tools/images/v2/optimism/7%2FrdF%2Fe%2F0iXY8HduhRCoIehkmFeXPeOQQFbbmIPfjCZ87s15hYR0nKEHNXp0ibUynoFehZ7Wua0JC2FmspHQZ5uhhsBeBTPzXID0RD7gayLsTUjPmvn%2B3w1y4pz0uT1wjryE%2BcmSUdzDmdlYKKGbfQ%3D%3D>"
        },
        "collection": {
          "id": "0x63a9addf2327a0f4b71bcf9bfa757e333e1b7177",
          "name": "BackedCommunity",
          "image": null
        },
        "amount": "1",
        "txHash": "0x1438962b09a1fd6405c7a0260c3dcf0b1eb550ab7682881a3b46bbd5a12f3a9b"
      }
    },
    {
			"type": "nft_transfer",
			"fromAddress": "0x3e56f641b878423994af52d8535875c0a00d2dbb",
			"toAddress": "0x428918fa22db0f356f977136bb0e06c6f7db7559",
			"timestamp": "2024-10-16T11:15:31.000Z",
			"data": {
				"contract": "0x5b9f7869966340902ce5cb50100ab9a77c123a99",
				"nft": {
					"tokenId": "36052",
					"name": "Fa$h Coupon v2 #36052",
					"image": "<https://img.reservoir.tools/images/v2/optimism/R1sZ%2FCm45ubSHnZEUHxI4hzz%2FxuQ%2For%2FbCW2o78BLjjk6abux2yzUba%2ByJWxqQnyNu3HJbu%2Fh1j%2FDYi%2Fnn%2Bb3X%2F4g7dO58a0dKrOIcQYli3W0vYlu9aidRX%2BEIz4xvLA.png>",
					"isSpam": false,
					"isNsfw": false
				},
				"collection": {
					"id": "0x5b9f7869966340902ce5cb50100ab9a77c123a99",
					"name": "Fa$h Coupons by BNV",
					"image": "<https://img.reservoir.tools/images/v2/optimism/z9JRSpLYGu7%2BCZoKWtAuAI37ZMpGmBWtUpAQDl1tI6Ad96hf%2BLS0ttnRCdlklL%2Fckl33iAZzvZSNjgZGpVP8pMn3DqdON95E%2BsRrAn5jRHqnAmF6mKXVg0uLv3cJn6zHygls6RV2jU8%2FsFZcu2l%2BlQ%3D%3D>",
					"isSpam": false,
					"isNsfw": false
				},
				"amount": "1",
				"txHash": "0x2c39f6255520000b7af5efe8a7347b808e45a20ff870553b414cb35849d6889b"
			}
		},
		{
			"type": "nft_sale",
			"fromAddress": "0x3e56f641b878423994af52d8535875c0a00d2dbb",
			"toAddress": "0x428918fa22db0f356f977136bb0e06c6f7db7559",
			"timestamp": "2024-10-16T11:15:31.000Z",
			"data": {
				"contract": "0x5b9f7869966340902ce5cb50100ab9a77c123a99",
				"nft": {
					"tokenId": "36052",
					"name": "Fa$h Coupon v2 #36052",
					"image": "<https://img.reservoir.tools/images/v2/optimism/R1sZ%2FCm45ubSHnZEUHxI4hzz%2FxuQ%2For%2FbCW2o78BLjjk6abux2yzUba%2ByJWxqQnyNu3HJbu%2Fh1j%2FDYi%2Fnn%2Bb3X%2F4g7dO58a0dKrOIcQYli3W0vYlu9aidRX%2BEIz4xvLA.png>",
					"isSpam": false,
					"isNsfw": false
				},
				"collection": {
					"id": "0x5b9f7869966340902ce5cb50100ab9a77c123a99",
					"name": "Fa$h Coupons by BNV",
					"image": "<https://img.reservoir.tools/images/v2/optimism/z9JRSpLYGu7%2BCZoKWtAuAI37ZMpGmBWtUpAQDl1tI6Ad96hf%2BLS0ttnRCdlklL%2Fckl33iAZzvZSNjgZGpVP8pMn3DqdON95E%2BsRrAn5jRHqnAmF6mKXVg0uLv3cJn6zHygls6RV2jU8%2FsFZcu2l%2BlQ%3D%3D>",
					"isSpam": false,
					"isNsfw": false
				},
				"order": {
					"id": "0x4fadd46b9a6c2834eaef9e1f61a64f6efc788fb7dcf4ddf8eebedc9dffbfc308",
					"side": "ask",
					"source": {
						"domain": "opensea.io",
						"name": "OpenSea",
						"icon": "<https://raw.githubusercontent.com/reservoirprotocol/assets/main/sources/opensea-logo.svg>"
					},
					"criteria": {
						"kind": "token",
						"data": {
							"collection": {
								"id": "0x5b9f7869966340902ce5cb50100ab9a77c123a99",
								"name": "Fa$h Coupons by BNV",
								"image": "<https://i.seadn.io/s/raw/files/42f109d7be8e58262c7c6fe98c34ee40.png?w=500&auto=format>",
								"isSpam": false,
								"isNsfw": false
							},
							"token": {
								"tokenId": "36052",
								"name": "Fa$h Coupon v2 #36052",
								"image": "<https://bnv-production.s3.ap-east-1.amazonaws.com/fash-claim-v2/fa$h-coupon-image.png>",
								"isSpam": false,
								"isNsfw": false
							}
						}
					}
				},
				"price": {
					"token": {
						"contract": "0x0000000000000000000000000000000000000000",
						"name": "Ether",
						"symbol": "ETH",
						"decimals": 18
					},
					"amount": {
						"raw": "400000000000000",
						"decimal": 0.0004,
						"usd": 1.04083,
						"native": 0.0004
					}
				},
				"amount": "1",
				"txHash": "0x2c39f6255520000b7af5efe8a7347b808e45a20ff870553b414cb35849d6889b",
				"fillSource": {
					"domain": "opensea.io",
					"name": "OpenSea",
					"icon": "<https://raw.githubusercontent.com/reservoirprotocol/assets/main/sources/opensea-logo.svg>"
				}
			}
		},
    {
			"type": "nft_ask" / "nft_ask_cancel",
			"fromAddress": "0xcb8a74d8d90bcf4457c6790efd0aad9cb320684f",
			"toAddress": null,
			"timestamp": "1970-01-21T00:18:29.000Z",
			"data": {
				"contract": "0x9e497e2c8c837f952e1201daae0b873a9bb54d66",
				"nft": {
					"tokenId": "1364",
					"name": "Optimism 3D NFTs Evo Ed.3 #1364",
					"image": "<https://img.reservoir.tools/images/v2/optimism/i9YO%2F4yHXUdJsWcTqhqvfz9nPquqp1OHAPAH0YGgUDd73dU%2BqV2h7ZxEb865v1kwHTjQZBu3rXPMaSRiFcWNo5lK10RfiJwvXhddWDMdaKY%3D.webp>",
					"isSpam": false,
					"isNsfw": false
				},
				"collection": {
					"id": "0x9e497e2c8c837f952e1201daae0b873a9bb54d66",
					"name": "Optimism 3D NFTs Evo Ed.3",
					"image": "<https://img.reservoir.tools/images/v2/optimism/OZOACYlgslkWSExEBQXm4GJnfEllKswnl1ZQU5yXH0iBk%2BMKv46yyz%2B1P4dnJU%2Be56R%2BpSq%2FGDzmjCmYcj%2F71A%3D%3D>",
					"isSpam": false,
					"isNsfw": false
				},
				"price": {
					"token": {
						"contract": "0x0000000000000000000000000000000000000000",
						"name": "Ether",
						"symbol": "ETH",
						"decimals": 18
					},
					"amount": {
						"raw": "11110000000000",
						"decimal": 0.00001,
						"usd": 0.02891,
						"native": 0.00001
					}
				},
				"amount": "1"
			}
		},
		{
			"type": "nft_bid" / "nft_bid_cancel",
			"fromAddress": "0x2897be1b8411c248dfaab1186bdd89a3f4b2ffbe",
			"toAddress": null,
			"timestamp": "2024-10-16T20:23:09.000Z",
			"data": {
				"contract": "0x8e56343adafa62dac9c9a8ac8c742851b0fb8b03",
				"nft": null,
				"collection": {
					"id": "0x8e56343adafa62dac9c9a8ac8c742851b0fb8b03",
					"name": "Bored Town",
					"image": "<https://img.reservoir.tools/images/v2/optimism/28SsxFrHoAzyiyUIVmrVwlczOlntRxQAii%2B%2F%2BYY7DihGA7Cqm7LYYJa2JqaMsafFUcXdQz2uPgM6SXNCwMJEpAU0YWYbY5F7LTCyYA4LWUIrDzYLv5o0qd%2BJJIggHXKQ4jheLYKBtN0CaTIRfp1VcffnPPXql%2B3FjJX%2F2PDnxImpIn%2F7WtTioqpnqNBECtJd>",
					"isSpam": false,
					"isNsfw": false
				},
				"price": {
					"token": {
						"contract": "0x4200000000000000000000000000000000000006",
						"name": "Wrapped Ether",
						"symbol": "WETH",
						"decimals": 18
					},
					"amount": {
						"raw": "1100000000000000",
						"decimal": 0.0011,
						"usd": 2.85912,
						"native": 0.0011
					}
				},
				"amount": "2"
			}
		}
  ],
  "continuation": null
}

Get Tokens Balance

GET /portfolio/tokens/balance/v1

This endpoint returns token balances for a specific wallet address.