GET
/
v1
/
portfolios
curl --request GET \
  --url https://api.getnimbus.io/v1/portfolios
[
  {
    "address": "<string>",
    "chain": "<string>",
    "holding": [
      {
        "owner": "0x7383b5e076553f79822374baca843c8fac02d510fb0f4ab344fc7ab591be94a7",
        "name": "suirwd.io - Sui Reward Token",
        "symbol": "SUIRWD.IO",
        "logo": "https://suicamp.b-cdn.net/suireward/suirwd_icon.png",
        "amount": "9683.2",
        "amountRaw": "9683200000000",
        "balance": "9683.2",
        "contractAddress": "0xca2c295de7931476539e5fc68e96c289f84bb0967d579b13e1fbf84412c87eb4::SuiReward::SUIREWARD",
        "contractDecimals": 9,
        "rate": 0,
        "price": {
          "price": 0,
          "symbol": "SUIRWD.IO",
          "decimal": 9,
          "source": "C"
        },
        "last_24h_price": "2023-11-07T05:31:56Z",
        "avgCost": 0,
        "last_transferred_at": "2023-11-07T05:31:56Z",
        "positionId": "SUI-0xca2c295de7931476539e5fc68e96c289f84bb0967d579b13e1fbf84412c87eb4::SuiReward::SUIREWARD",
        "category": "Other",
        "sector": "Other",
        "rank": "No rank yet",
        "positionType": "token",
        "chain": "SUI",
        "is_spam": true
      }
    ],
    "positions": [
      {
        "positionId": "0x7016aae72cfc67f2fadf55769c0a7dd54291a583b63051a5ed71081cce836ac6::sca::SCA",
        "owner": "0x7383b5e076553f79822374baca843c8fac02d510fb0f4ab344fc7ab591be94a7",
        "input": [
          {
            "amount": 230.1003476015875,
            "value": 89.34665515948616,
            "token": {
              "contract_address": "0x7016aae72cfc67f2fadf55769c0a7dd54291a583b63051a5ed71081cce836ac6::sca::SCA",
              "timestamp": 1732681440,
              "price": 0.38829430763915,
              "last24hPrice": 0.2,
              "poolId": "lending:0x83556891f4a0f233ce7b05cfe7f957d4020492a34f5405b2cb9377d060bef4bf::spring_sui::SPRING_SUI",
              "decimals": 9,
              "name": "Scallop",
              "symbol": "SCA",
              "source": "Nimbus",
              "logo": "https://token-logo.service.getnimbus.io/api/v1/logo?address=0x7016...&chain=SUI"
            }
          }
        ],
        "yieldCollected": [
          {
            "amount": 230.1003476015875,
            "value": 89.34665515948616,
            "token": {
              "contract_address": "0x7016aae72cfc67f2fadf55769c0a7dd54291a583b63051a5ed71081cce836ac6::sca::SCA",
              "timestamp": 1732681440,
              "price": 0.38829430763915,
              "last24hPrice": 0.2,
              "poolId": "lending:0x83556891f4a0f233ce7b05cfe7f957d4020492a34f5405b2cb9377d060bef4bf::spring_sui::SPRING_SUI",
              "decimals": 9,
              "name": "Scallop",
              "symbol": "SCA",
              "source": "Nimbus",
              "logo": "https://token-logo.service.getnimbus.io/api/v1/logo?address=0x7016...&chain=SUI"
            }
          }
        ],
        "current": {
          "tokens": [
            {
              "amount": 230.1003476015875,
              "value": 89.34665515948616,
              "token": {
                "contract_address": "0x7016aae72cfc67f2fadf55769c0a7dd54291a583b63051a5ed71081cce836ac6::sca::SCA",
                "timestamp": 1732681440,
                "price": 0.38829430763915,
                "last24hPrice": 0.2,
                "poolId": "lending:0x83556891f4a0f233ce7b05cfe7f957d4020492a34f5405b2cb9377d060bef4bf::spring_sui::SPRING_SUI",
                "decimals": 9,
                "name": "Scallop",
                "symbol": "SCA",
                "source": "Nimbus",
                "logo": "https://token-logo.service.getnimbus.io/api/v1/logo?address=0x7016...&chain=SUI"
              }
            }
          ],
          "yield": [
            {
              "amount": 230.1003476015875,
              "value": 89.34665515948616,
              "token": {
                "contract_address": "0x7016aae72cfc67f2fadf55769c0a7dd54291a583b63051a5ed71081cce836ac6::sca::SCA",
                "timestamp": 1732681440,
                "price": 0.38829430763915,
                "last24hPrice": 0.2,
                "poolId": "lending:0x83556891f4a0f233ce7b05cfe7f957d4020492a34f5405b2cb9377d060bef4bf::spring_sui::SPRING_SUI",
                "decimals": 9,
                "name": "Scallop",
                "symbol": "SCA",
                "source": "Nimbus",
                "logo": "https://token-logo.service.getnimbus.io/api/v1/logo?address=0x7016...&chain=SUI"
              }
            }
          ]
        },
        "fee": 0,
        "chain": "SUI",
        "type": "Staking",
        "farming": [
          {
            "base_apr": 10,
            "rewards_apr": 20,
            "total_apr": 30,
            "total_apy": 40,
            "rewards": [
              {
                "token_address": "0x7016aae72cfc67f2fadf55769c0a7dd54291a583b63051a5ed71081cce836ac6::sca::SCA",
                "logo": "https://token-logo.service.getnimbus.io/api/v1/logo?address=0x7016...&chain=SUI",
                "token_name": "Scallop",
                "token_symbol": "SCA",
                "token_decimals": 9
              }
            ]
          }
        ],
        "meta": {
          "protocol": {
            "name": "Scallop",
            "logo": "https://strapi-dev.scand.app/uploads/Scallop_e86ded6cf4.jpg",
            "url": "https://scallop.io/",
            "protocol": "Scallop"
          }
        }
      }
    ]
  }
]

Query Parameters

​
addresses
string
required

Comma-separated list of addresses (max 50)

​
chain
string

Chain identifier (currently only supports ECLIPSE)

Response

200
application/json
Successfully retrieved positions
​
address
string

The wallet address

​
chain
string

Chain identifier

​
holding
object[]

List of holdings filtered by whitelisted contract addresses

​
positions
object[]

List of Eclipse user positions