Skip to main content
GET
/
wallet
/
defi
Retrieve comprehensive DeFi portfolio data, including staking, liquidity pool (LP), and yield farming activities
curl --request GET \
  --url https://openapiv1.coinstats.app/wallet/defi \
  --header 'X-API-KEY: <api-key>'
{
  "totalAssets": {
    "USD": 46.92,
    "ETH": 0.010799824088855844,
    "BTC": 0.0004264134046889636
  },
  "protocols": [
    {
      "id": "pancakeswap-amm-v3",
      "name": "PancakeSwap",
      "logo": "https://icons.llama.fi/pancakeswap-amm-v3.jpg",
      "totalValue": {
        "USD": 46.92,
        "ETH": 0.010799824088855844,
        "BTC": 0.0004264134046889636
      },
      "blockchain": {
        "name": "Solana",
        "icon": "https://static.coinstats.app/portfolio_images/solana_dark.png"
      },
      "chain": "solana",
      "investments": [
        {
          "id": "liquidity",
          "name": "Liquidity",
          "value": {
            "USD": 46.92,
            "ETH": 0.010799824088855844,
            "BTC": 0.0004264134046889636
          },
          "symbols": "USDC + WSOL",
          "assets": [
            {
              "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
              "title": "Deposit",
              "amount": 20.431941,
              "symbol": "USDC",
              "price": {
                "USD": 46.92,
                "ETH": 0.010799824088855844,
                "BTC": 0.0004264134046889636
              },
              "coinId": "solana",
              "logo": "https://img-v1.raydium.io/icon/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v.png",
              "danger": true
            }
          ],
          "poolAddress": "pancakeswap-amm-v3",
          "healthRate": 123,
          "healthRateLink": "<string>",
          "poolProjectId": "PancakeSwap",
          "unlockAt": "2025-08-28T08:35:50.384Z",
          "endAt": "2025-08-28T08:35:50.384Z",
          "isProxy": true,
          "debtRatio": 0.01,
          "debtRatioLink": "https://pancakeswap.finance/swap"
        }
      ],
      "walletAddress": "wallet_address_here",
      "url": "https://pancakeswap.finance/swap"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://coinstats.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint is only available for OpenApi users with paid subscription.
400 credits per request
In Query field “connectionId”: credits are multiplied by the number of values.
If the value of “connectionId” in Query is “all”, multiplier is 4000 credits.
Detailed multipliers explanation
  • Detailed breakdown of DeFi assets and protocols
  • Track staked tokens, LP positions, and earned rewards
  • address and connectionId: For single wallet queries

Authorizations

​
X-API-KEY
string
header
required

API key needed to access the endpoints. Example: 'demo-api-key'

Query Parameters

​
address
string
required

The wallet address for which the DeFi data is being queried. Must be a valid string representing an EVM-compatible wallet address.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
connectionId
string

Specifies the blockchain network connection ID to query for DeFi data. Can be a single network (e.g., "ethereum") or comma-separated list of networks (e.g., "ethereum,polygon-wallet") or "all" for all networks. Either connectionId or blockchain must be provided. If both are provided, connectionId will be used.

Example:

"base-wallet"

​
blockchain
string

The blockchain network identifier from /wallet/blockchains call response. Can be a single network (e.g., "ethereum") or a comma-separated list of networks (e.g., "ethereum,polygon,binance_smart"). Either connectionId or blockchain must be provided. If both are provided, connectionId will be used.

Example:

"base"

Response

Defi Response

​
totalAssets
object
required

Total value of all DeFi positions across all protocols

​
protocols
object[]
required

List of DeFi protocols with user positions