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 /portfolio/tokens/balance/v1
This endpoint returns token balances for a specific wallet address.