Skip to main content
GET
/
v1
/
wallets
/
{walletAddress}
/
defi
/
{protocol}
/
positions
Get DeFi positions for a specific protocol
curl --request GET \
  --url https://api.moralis.com/v1/wallets/{walletAddress}/defi/{protocol}/positions \
  --header 'X-Api-Key: <api-key>'
{
  "meta": {
    "syncedAt": {
      "0x1": 1710000000,
      "solana-mainnet": "latest"
    },
    "unsupportedChains": [
      "0x89"
    ],
    "failedChains": [
      "0x89"
    ]
  },
  "cursor": "eyJhbGciOi...VCaaw",
  "result": {
    "protocolId": "<string>",
    "protocolName": "<string>",
    "chainId": "0x1",
    "totalUsd": {},
    "totalUnclaimedUsd": {},
    "positions": [
      {
        "tokens": [
          {
            "address": "<string>",
            "name": {},
            "symbol": {},
            "decimals": {},
            "logo": {},
            "balance": {},
            "balanceFormatted": {},
            "usdPrice": {},
            "usdValue": {}
          }
        ],
        "address": {},
        "balanceUsd": {},
        "unclaimedUsd": {},
        "details": {
          "isDebt": true,
          "lending": {
            "healthFactor": {}
          },
          "liquidity": {
            "poolAddress": {}
          }
        }
      }
    ],
    "protocolUrl": {},
    "protocolLogo": {}
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.moralis.com/llms.txt

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

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
walletAddress
string
required

The address

​
protocol
string
required

Protocol identifier (e.g. "aave-v3", "uniswap-v3")

Example:

"aave-v3"

Query Parameters

​
chains
enum<string>[]

Chains to query

Available options:
0x1,
ethereum,
0x15b38,
chiliz,
0x19,
cro,
0x2105,
base,
0x38,
binance,
0x440,
metis,
0x46f,
lisk,
0x504,
moon beam,
0x505,
moon river,
0x531,
sei,
0x64,
gnosis,
0x7e4,
ronin,
0x89,
polygon,
0x8f,
monad,
0x92,
sonic,
0xa,
optimism,
0xa4b1,
arbitrum,
0xa86a,
avalanche,
0xe708,
linea,
0xfa,
fantom,
solana-mainnet,
sol,
all,
mainnets,
testnets
​
limit
number
default:25

Maximum number of positions to return per page

Required range: 1 <= x <= 100
​
cursor
string

Pagination cursor for next page

Response

200 - application/json
​
meta
object
required
​
cursor
string | null
required

The cursor to be used for getting the next page of results

Example:

"eyJhbGciOi...VCaaw"

​
result
object