Get detailed DeFi positions by wallet and protocol

GEThttps://deep-index.moralis.io/api/v2.2/wallets/:address/defi/:protocol/positions

Get the detailed defi positions by protocol for a wallet address.

PATH PARAMS

addressstringrequired

Wallet address

protocolstringrequired

The protocol to query

uniswap-v2uniswap-v3pancakeswap-v2pancakeswap-v3quickswap-v2sushiswap-v2aave-v2aave-v3fraxswap-v1fraxswap-v2lidomakerdaoeigenlayer

QUERY PARAMS

chainstring

The chain to query

eth0x1sepolia0xaa36a7polygon0x89bsc0x38bsc testnet0x61avalanche0xa86afantom0xfacronos0x19arbitrum0xa4b1chiliz0x15b38chiliz testnet0x15b32gnosis0x64gnosis testnet0x27d8base0x2105base sepolia0x14a34optimism0xaholesky0x4268polygon amoy0x13882linea0xe708moonbeam0x504moonriver0x505moonbase0x507linea sepolia0xe705

Responses

200Returns the defi positions by protocol for the wallet address.

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/wallets/0xd100d8b69c5ae23d6aa30c6c3874bf47539b95fd/defi/aave-v3/positions?chain=eth' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

Node.js

// Node.js v18+ has native fetch support
// No additional dependencies required

const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
};

fetch('https://deep-index.moralis.io/api/v2.2/wallets/0xd100d8b69c5ae23d6aa30c6c3874bf47539b95fd/defi/aave-v3/positions?chain=eth', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Python

# Dependencies to install:
# $ python -m pip install requests

import requests

url = "https://deep-index.moralis.io/api/v2.2/wallets/0xd100d8b69c5ae23d6aa30c6c3874bf47539b95fd/defi/aave-v3/positions?chain=eth"

headers = {
  "Accept": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

Go

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/wallets/0xd100d8b69c5ae23d6aa30c6c3874bf47539b95fd/defi/aave-v3/positions?chain=eth"

  req, _ := http.NewRequest("GET", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-API-Key", "YOUR_API_KEY")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

PHP

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://deep-index.moralis.io/api/v2.2/wallets/0xd100d8b69c5ae23d6aa30c6c3874bf47539b95fd/defi/aave-v3/positions?chain=eth', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 Returns the defi positions by protocol for the wallet address.

{
  "protocol_name": "Uniswap v2",
  "protocol_id": "uniswap-v2",
  "protocol_url": "https://app.uniswap.org/pools/v2",
  "protocol_logo": "https://cdn.moralis.io/defi/uniswap.png",
  "total_usd_value": 47754.14278954011,
  "total_unclaimed_usd_value": "",
  "positions": [
    {
      "label": "liquidity",
      "tokens": [
        {
          "token_type": "defi-token",
          "name": "Wrapped Ether",
          "symbol": "WETH",
          "contract_address": "0x06012c8cf97bead5deae237070f9587f8e7a266d",
          "decimals": 18,
          "logo": "https://logos.covalenthq.com/tokens/0x0000000000085d4780b73119b644ae5ecd22b376.png",
          "thumbnail": "https://logos.covalenthq.com/tokens/0x0000000000085d4780b73119b644ae5ecd22b376.png",
          "balance": "1000000",
          "balance_formatted": "1.000000",
          "usd_price": 1000000,
          "usd_value": 1000000
        }
      ],
      "address": "0x06012c8cf97bead5deae237070f9587f8e7a266d",
      "balance_usd": 1000000,
      "total_unclaimed_usd_value": 1000000,
      "position_details": {
        "fee_tier": 1,
        "range_tnd": 1,
        "reserves": [
          "string"
        ],
        "current_price": 1,
        "is_in_range": true,
        "price_upper": 1,
        "price_lower": 1,
        "price_label": "string",
        "liquidity": 1,
        "range_start": 1,
        "pool_address": "string",
        "position_key": "string",
        "asset_standard": "string",
        "apy": 1,
        "is_debt": true,
        "is_variable_debt": true,
        "is_stable_debt": true,
        "shares": "string",
        "reserve0": "string",
        "reserve1": "string",
        "factory": "string",
        "pair": "string",
        "share_of_pool": 1
      }
    }
  ]
}