DeFi Position Data API: LP and Lending Endpoints

REST API for LP and lending positions: value, PnL, fees, impermanent loss, APR and health factor. Prepaid credits, fixed cost per endpoint.

Canonical: https://defiorbit.xyz/products/api-platform

---

[Products](/#products)/API Platform

# LP and lending position data, by API

Current value, PnL, impermanent loss, fees, APR, TWIC, health factors and full event history. Served from our own indexers, not proxied through a third party.

[Get API key](https://platform.defiorbit.xyz)[Read the docs](https://docs.defiorbit.xyz/)

Pay per call. No subscription, no seat fees. Credits don’t expire while you’re using them. Includes our MCP server for AI agents.

GET /v1/positions/uniswapv32 credits

```
{
  "data": [
    {
      "token_id": "119128",
      "chain_id": 130,
      "is_active": true,
      "position_state": {
        "token0": { "symbol": "USDC" },
        "token1": { "symbol": "HYPE" },
        "liquidity": "1175583669061921"
      }
    }
  ],
  "counts": {
    "totalActive": 1,
    "totalInactive": 12,
    "total": 13
  }
}
```

The platform

## From sign-up to first response in a few minutes

Create an account at platform.defiorbit.xyz, generate a key and send a test request from the browser. Keys, credits, usage and API status sit on one screen.

platform.defiorbit.xyz

![API Platform overview with credits remaining, active API keys, API status, quick actions and popular endpoints with their credit cost](/assets/app-overview.webp)

### Self-serve

No sales call needed to start. Sign up, buy a pack, call the API.

### One key, REST and MCP

The same key works for direct API calls and for AI agents over MCP.

### Built for teams

Invite members to your organization and share keys, credits and billing.

### Live API status

Operational status is shown in the dashboard, next to your balance.

01 / LP Position APIs

## Full lifecycle data for concentrated liquidity positions

-   Uniswap V3
    
    Ethereum, Base, Arbitrum, Optimism, Unichain, Polygon, BNB Smart Chain, Avalanche and Robinhood Chain
    
-   Aerodrome Slipstream
    
    Base
    
-   Orca Whirlpools
    
    Solana, including DeFi Tuna positions
    

Endpoint

Returns

Credits

/summary

Wallet-level active and inactive position counts

1

/ (list)

All active positions for a wallet

2

/:id

Raw on-chain state for one position

2

/:id/events

Deposit, withdrawal, fee collection and compound history

1

/:id/snapshots

Daily historical performance

2

/:id/snapshot

Current health check: value, range, PnL, APR

5

/:id/pnl

Profit and loss figures

8

/:id/yield

Fee and reward accrual with projected yield

8

/:id/full

State, history, PnL, impermanent loss, fees, APR and TWIC in one call

15

/batch (POST)

Position list for multiple wallets in one request

12

Orca currently supports summary, list, single position and batch. Events, snapshots, PnL, yield and full are in progress.

02 / Lending APIs

## Health factor, liquidation risk and interest, per wallet

-   Aave V3
    
    Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Smart Chain and Avalanche; main, Lido and Horizon markets
    
-   Morpho Blue
    
    Ethereum and Base; isolated markets
    
-   Kamino
    
    Solana; obligation-based
    

Endpoint

Returns

Credits

/summary

Lightweight check: is this wallet at risk anywhere (3 credits on Aave V3)

1

/position

Live positions across all chains, no calculations

3

/position/:chain\_id/events

Supply, borrow, withdraw, repay and liquidation history

1

/position/:chain\_id/snapshots

Daily historical performance

2

/position/:chain\_id/risk

Liquidation distance, LTV, safe borrow and withdraw amounts

8

/position/:chain\_id/yield

Interest earned and paid, net APY, projections

8

/ (list, calculated)

Full detail with health factor, APY and per-asset breakdown

15

/batch (POST)

Calculated list for multiple wallets in one request

12

Coming soonPortfolio APIWallet-level token holdings and total USD balance across chains.

03 / Developer console

## Try every endpoint before you write a line of code

Each endpoint has its credit cost, an example request and a real example response. Paste a wallet address, pick a key and run it from the browser.

platform.defiorbit.xyz/endpoints

![Endpoints explorer showing List Aave V3 Positions at 15 credits, with an example request, an example JSON response and a Try it panel](/assets/app-endpoints.webp)

Endpoint explorer

Grouped by protocol: Uniswap V3, Aerodrome, Orca, Aave, Morpho and Kamino.

Try it in the browser

Run a live call with your own key and see the response and its cost.

LLM instructions

A ready-made brief you can hand to a coding assistant so it calls the API correctly.

Keys with rate limits

Create a key per app or environment. Each key shows its rate limit and total calls.

platform.defiorbit.xyz/keys

![API Keys table listing three keys with masked tokens, a rate limit of 5 requests per second each and total calls](/assets/app-keys.png)

04 / Usage & logs

## See exactly where every credit went

Usage is broken down by endpoint, by key and by status code. Credits used by a failed request are refunded to your balance.

platform.defiorbit.xyz/usage

![Usage page with credits used and left, an API calls chart over the past 24 hours and a table of requests and credits per API path](/assets/app-usage.webp)

platform.defiorbit.xyz/logs

![Request logs table with request path, API key, HTTP status, response time, credits used and time sent](/assets/app-logs.png)

Usage over time

Filter by time range and by API key to see which app is spending what.

Cost per endpoint

Requests, credit cost and consumed credits for every path you call.

Request logs

Every request with key, HTTP status, response time and credits used.

Status breakdown

Successful, invalid, unauthorized and rate-limited requests, counted separately.

05 / DeFi Orbit AI

## Give your AI agents position-level data

Connect Claude, Cursor, VS Code or any MCP-compatible client. The agent calls the same endpoints during a conversation, with the same key.

Read-only by design

No tool can move funds or change on-chain state.

Same billing, same limits

Every tool call costs the same credits as the matching API call.

One tool per endpoint

Summary, list, batch, single position, events and snapshots, grouped by protocol.

[See DeFi Orbit AI →](/products/defi-orbit-ai)

platform.defiorbit.xyz/mcp

![MCP Server page with a JSON connection config using a bearer API key and a list of available read-only Uniswap V3 tools](/assets/app-mcp.webp)

06 / Billing

## Pay only for what you call

Every endpoint has a fixed, published credit cost. A wallet summary costs 1 credit. A full position breakdown with PnL and event history costs 15. Buy credits once; they don’t expire while you’re using them.

Starter

$10

500 credits

For testing the API

Builder

$100

5,000 credits

For side projects and prototypes

ProductionPopular

$2,000

100,000 credits

For production apps

Scale

$19,000

1,000,000 credits

For high-volume platforms

Enterprise

Custom

Volume based on your needs

A custom plan built around your data, volume and integrations

[Talk to sales →](/book-a-demo)

The cost is in every response

Each API response states exactly what it cost. No multipliers, no overage penalties.

Granted credits are used first

Bonus and partner grants are consumed before anything you paid for. Purchased credits don’t expire while your account is active.

Top-up history and invoices

Every purchase and grant is listed with its date and credits. Purchases come with an invoice.

Committed plans for teams

Enterprise and partner agreements include a monthly credit grant and custom integrations.

FAQ

## Questions about the API Platform

How do I get started?

Create an account at platform.defiorbit.xyz, generate a key and make your first call. The Starter pack is 500 credits for $10, enough to test every endpoint against real wallets.

How does pricing work?

Prepaid credits with a fixed cost per endpoint, from 1 to 30 credits per call. Each response shows what it cost, failed requests are free, and purchased credits don’t expire while your account is active, so spend is predictable before you ship.

How current is the data?

Real time on every request. Positions are read as they are at the moment you call, so a rebalance a minute ago shows up.

What are the rate limits?

5 requests per second per key by default. If your product needs more, contact us and we’ll raise it for your key.

Which protocols and networks are covered?

Uniswap V3, Aerodrome and Orca for liquidity, Aave, Morpho and Kamino for lending, across ten networks. The Supported networks page lists which deployments are live for each protocol, and new protocols come through Custom Data.

Is there an uptime commitment?

Live status and incident history are at status.defiorbit.xyz.

Compare solutions

## Choosing a data source? See how we compare

[See all comparisons →](/compare)

1.  [01
    
    Build it yourself
    
    DeFi Orbit vs. building it in-house
    
    For teams deciding whether to run their own indexers and calculation engine or call an API.
    
    ](/compare/in-house)
2.  [02
    
    Indexing protocols
    
    DeFi Orbit vs. subgraphs
    
    For developers who query protocol subgraphs today and assemble positions from events.
    
    ](/compare/subgraphs)
3.  [03
    
    Portfolio APIs
    
    DeFi Orbit vs. Zerion API
    
    For builders choosing between a broad wallet API and deep LP and lending data.
    
    ](/compare/zerion)
4.  [04
    
    Analytics platforms
    
    DeFi Orbit vs. Dune
    
    For analysts who write and maintain SQL to answer position questions.
    
    ](/compare/dune)

## Start with 500 credits for $10

Or talk to us about a committed plan and custom data.

[Get API key](https://platform.defiorbit.xyz)[Book a demo](/book-a-demo)

×

Book a demo

## See how DeFi Orbit fits your stack

Thirty minutes with the team. Bring a wallet address and the report you wish you had.

-   A walkthrough using your positions, not sample data
-   Which product fits: Portfolio, the API or both
-   Pricing for your wallets, clients and volume

Just want to try it? [Get an API key](https://platform.defiorbit.xyz) or[launch the app](https://app.defiorbit.xyz).

1.  1 · Your details
2.  2 · Pick a time

## Pick a time, there

30 minutes · Video call · Your details are filled in for you

← Edit details[Open the calendar in a new tab ↗](#)
