Quickstart

This endpoint returns the total number of Uniswap V3 positions for a wallet, split into active and inactive positions. The request costs 1 API credit.

Prerequisites

Access to the DeFi Orbit dashboard
A wallet address to query

Create an API key

Open API Keys and create a key. The API key starts with do_sk_. Copy and store the full key securely when creating it.

Call the summary endpoint

Send your API key in the Authorization header as a Bearer token. Replace the example wallet address with the wallet you want to query.

curl
JavaScript
Python

curl --location 'https://api.defiorbit.xyz/v1/positions/uniswapv3/summary?wallet=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045' \
  --header 'Authorization: Bearer YOUR_API_KEY'

const url = new URL("https://api.defiorbit.xyz/v1/positions/uniswapv3/summary");
url.searchParams.set("wallet", "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045");

const response = await fetch(url, {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

const body = await response.json();

if (!response.ok) {
  const { code, request_id } = body.error;
  throw new Error(`${response.status} ${code} (${request_id})`);
}

console.log(body);

import requests

response = requests.get(
    "https://api.defiorbit.xyz/v1/positions/uniswapv3/summary",
    params={"wallet": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())

Read the counts

data.total_active is the number of active positions. data.total_inactive is the number of inactive positions.

{
  "data": {
    "total": 8,
    "total_active": 5,
    "total_inactive": 3
  },
  "request_id": "req_..."
}

List those positions with List Uniswap V3 Positions. Retry 429, 502, 503, and 504 as shown in Errors and rate limits.

Need a hand? Email support@defiorbit.xyz.

Overview

Concepts

Recipes

Prerequisites

​Prerequisites

Prerequisites