Skip to main content
GET
/
2
/
wallet
/
defi-positions
Get Wallet DeFi Positions
curl --request GET \
  --url https://demo-api.mobula.io/api/2/wallet/defi-positions
{
  "data": {
    "wallet": "<string>",
    "fetchedAt": "<string>",
    "totalValueUSD": "<string>",
    "protocols": [
      {
        "protocol": {
          "id": "<string>",
          "name": "<string>",
          "url": "<string>",
          "category": "lending"
        },
        "totalValueUSD": "<string>",
        "positions": [
          {
            "id": "<string>",
            "type": "deposit",
            "name": "<string>",
            "valueUSD": "<string>",
            "tokens": [
              {
                "address": "<string>",
                "symbol": "<string>",
                "name": "<string>",
                "decimals": 123,
                "amount": "<string>",
                "amountFormatted": "<string>",
                "priceUSD": "<string>",
                "valueUSD": "<string>"
              }
            ],
            "rewards": [
              {
                "address": "<string>",
                "symbol": "<string>",
                "name": "<string>",
                "decimals": 123,
                "amount": "<string>",
                "amountFormatted": "<string>",
                "priceUSD": "<string>",
                "valueUSD": "<string>"
              }
            ],
            "metadata": {}
          }
        ]
      }
    ],
    "totalDepositedUSD": "<string>",
    "totalBorrowedUSD": "<string>",
    "totalRewardsUSD": "<string>"
  }
}

​
Query Parameters

ParameterTypeRequiredDescription
walletstringYesWallet address (EVM 0x... format or Solana base58 format).
blockchainsstringYesBlockchain name or ID (e.g., solana, ethereum).

​
Supported Protocols

​
Solana

CategoryProtocols
LendingMarginFi, Solend
DEX (LP)Orca, Raydium, Meteora
Liquid StakingJito, Marinade, BlazeStake, Sanctum

​
EVM (Ethereum)

CategoryProtocols
LendingAave

​
Usage Examples

  • Query DeFi positions on Solana
curl -X GET "https://api.mobula.io/api/2/wallet/defi-positions?wallet=7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs&blockchains=solana" \
  -H "Authorization: YOUR_API_KEY"

​
Response Format

{
  "data": {
    "wallet": "6Doy9NiFN4euSrkzpbYfyZe7p3pkgERumMmvoGvDEGrP",
    "fetchedAt": "2026-01-07T13:44:48.674Z",
    "totalValueUSD": "5732.07",
    "totalDepositedUSD": "5732.07",
    "totalBorrowedUSD": "0.00",
    "totalRewardsUSD": "781.11",
    "protocols": [
      {
        "protocol": {
          "id": "orca",
          "name": "Orca",
          "url": "https://www.orca.so",
          "category": "lp"
        },
        "totalValueUSD": "5389.51",
        "positions": [
          {
            "id": "orca-whirlpool-HjAfSzsb",
            "type": "liquidity",
            "name": "SOL/USDC LP",
            "valueUSD": 544.02,
            "tokens": [
              {
                "address": "So11111111111111111111111111111111111111112",
                "symbol": "SOL",
                "name": "Wrapped SOL",
                "decimals": 9,
                "amountRaw": "3804402285",
                "amountFormatted": 3.804402,
                "priceUSD": 138.1587,
                "valueUSD": 525.61
              },
              {
                "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "symbol": "USDC",
                "name": "USD Coin",
                "decimals": 6,
                "amountRaw": "0",
                "amountFormatted": 0,
                "priceUSD": 1.0002,
                "valueUSD": 0
              }
            ],
            "rewards": [
              {
                "address": "So11111111111111111111111111111111111111112",
                "symbol": "SOL",
                "name": "SOL Fees",
                "decimals": 9,
                "amountRaw": "49891954",
                "amountFormatted": 0.049892,
                "priceUSD": 138.1587,
                "valueUSD": 6.89
              },
              {
                "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "symbol": "USDC",
                "name": "USDC Fees",
                "decimals": 6,
                "amountRaw": "11513560",
                "amountFormatted": 11.51356,
                "priceUSD": 1.0002,
                "valueUSD": 11.52
              }
            ],
            "metadata": {
              "type": "liquidity",
              "poolAddress": "HJPjoWUrhoZzkNfRpHuieeFk9WcZWjwy6PBjZ81ngndJ",
              "poolName": "SOL/USDC",
              "poolType": "clmm",
              "tickLower": -14784,
              "tickUpper": -11456,
              "inRange": false
            }
          }
        ]
      },
      {
        "protocol": {
          "id": "jito",
          "name": "Jito",
          "url": "https://www.jito.network",
          "category": "liquid-staking"
        },
        "totalValueUSD": "64.86",
        "positions": [
          {
            "id": "jito-stake-jitosol-6Doy9NiF",
            "type": "stake",
            "name": "Jito Staked SOL",
            "valueUSD": 64.86,
            "tokens": [
              {
                "address": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
                "symbol": "JitoSOL",
                "name": "Jito Staked SOL",
                "decimals": 9,
                "amountRaw": "374736373",
                "amountFormatted": 0.374736,
                "priceUSD": 173.09,
                "valueUSD": 64.86
              }
            ],
            "metadata": {
              "type": "liquid-staking",
              "lstMint": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
              "lstSymbol": "JitoSOL",
              "exchangeRate": "1.254063",
              "apy": "0.0589"
            }
          }
        ]
      },
      {
        "protocol": {
          "id": "marinade",
          "name": "Marinade",
          "url": "https://marinade.finance",
          "category": "liquid-staking"
        },
        "totalValueUSD": "4.20",
        "positions": [
          {
            "id": "marinade-stake-msol-6Doy9NiF",
            "type": "stake",
            "name": "Marinade Staked SOL",
            "valueUSD": 4.2,
            "tokens": [
              {
                "address": "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So",
                "symbol": "mSOL",
                "name": "Marinade Staked SOL",
                "decimals": 9,
                "amountRaw": "22490760",
                "amountFormatted": 0.022491,
                "priceUSD": 186.57,
                "valueUSD": 4.2
              }
            ],
            "metadata": {
              "type": "liquid-staking",
              "lstMint": "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So",
              "lstSymbol": "mSOL",
              "exchangeRate": "1.350434",
              "apy": "0.0605"
            }
          }
        ]
      }
    ]
  }
}

​
Metadata by Category

​
Lending Metadata

FieldTypeDescription
marketstringMarket name (e.g., “Main Market”, “JLP Market”).
healthFactorstringAccount health factor.
liquidationThresholdstringLiquidation threshold.
ltvstringLoan-to-value ratio.
supplyAPYstringTotal supply APY (base + token yield).
baseSupplyAPYstringBase lending APY from protocol.
tokenAPYstringNative yield for LSTs/yield-bearing tokens.
borrowAPYstringBorrow APY.
utilizationRatestringReserve utilization rate.

​
Liquidity (DEX) Metadata

FieldTypeDescription
poolAddressstringPool contract address.
poolNamestringPool name (e.g., “SOL/USDC”).
poolTypestringPool type: amm, clmm, or dlmm.
shareOfPoolstringUser’s share of the pool.
fee24hstringFees earned in last 24 hours.
apystringEstimated APY.
tickLowernumberLower tick bound (CLMM/DLMM only).
tickUppernumberUpper tick bound (CLMM/DLMM only).
inRangebooleanWhether position is currently in range.

​
Liquid Staking Metadata

FieldTypeDescription
lstMintstringLST token mint address.
lstSymbolstringLST token symbol (e.g., “mSOL”, “jitoSOL”).
exchangeRatestringLST to native token exchange rate.
apystringStaking APY.
unstakePendingstringAmount pending unstake.

Query Parameters

​
wallet
string
required

Wallet address (EVM 0x... format or Solana base58 format)

​
blockchains
string
required

Blockchain name or ID (e.g., "solana", "ethereum")

Response

200 - application/json

Wallet DeFi Positions response

​
data
object
required