DeFi Position Data API for Builders | DeFi Orbit Add LP and lending positions to your product with one HTTPS call. No indexers or RPC to run, fixed credit cost per endpoint. Canonical: https://defiorbit.xyz/clients/builders --- Clients/Builders and Developers # Ship DeFi products without the infrastructure hassle All of our vetted LP and lending data, available by API. No indexers to build, no RPC bills, no formulas to maintain. Plug in and build on day one. [Get API key](https://platform.defiorbit.xyz)[Read the docs](#docs) 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 } } ``` ## DeFi Orbit runs the data infrastructure, so you can ship the product How it is done today With DeFi Orbit ×Building and running your own indexers and nodes ✓Our infrastructure, behind one API ×Integrating every new protocol and fixing it after each upgrade ✓New protocols and upgrades handled by us ×Paying an RPC provider for every read ✓RPC costs for the data we provide are covered ×Writing and maintaining PnL, impermanent loss and APR formulas ✓Calculated, documented and kept current for you ×Infrastructure bills that swing from month to month ✓Prepaid credits with a fixed, published cost per call 01 / Use cases ## What builders do with DeFi Orbit Build on day oneCut infrastructure costSkip the formulasData for AI agents ### Plug into vetted data and ship this week ›Create a key and make your first call the same day ›LP position and lending APIs in one consistent shape ›From a 1-credit wallet summary to a full position breakdown ›Batch endpoints for many wallets in one request [See endpoints and pricing →](/products/api-platform) GET /v1/positions/uniswapv3/:id/full15 credits ``` { "data": { "positionData": { "id": "119128", "tickLower": "233160", "tickUpper": "236220", "token0": { "symbol": "USDC" }, "token1": { "symbol": "HYPE" }, "pool": { "feeTier": "3000" }, "chain": { "id": 130 }, "protocol": { "code": "uniswapV3" } }, "calculations": { "inRange": true, "positionUsdValue": "1482.71", "pnlUsdValue": "150.88", "pnlPercentage": "11.33", "netImpermanentLossPercentage": "-0.66", "positionAgeInDays": 33.16, "earnedAprPercentage": { "yield": "41.23", "fees": "41.23", "rewards": "0" } } } } ``` ### Replace indexers, nodes and RPC bills with one line item ›No indexers or nodes to build and run ›No RPC bills for the data we provide ›A fixed cost per endpoint, returned in every response ›Credits that don't expire while you use them, with a log of every request [See endpoints and pricing →](/products/api-platform) ![API Platform usage over time with calls, credits and per-endpoint requests](/assets/clients-api-usage.jpg) ### Leave the protocol math and its upkeep to us ›PnL, fees, impermanent loss, APR and TWIC already calculated ›Health factor, liquidation distance and safe borrow amounts ›Kept current when protocols change ›A documented method behind every figure [See endpoints and pricing →](/products/api-platform) GET /v1/positions/uniswapv3/:id/pnl8 credits ``` { "data": { "pnl_usd_value": "150.88", "pnl_percentage": "11.33", "time_weighted_average_capital": "1331.83", "hodl_gross_benchmark_usd_value": "1492.63", "market_pnl_usd_value": "160.80", "lp_divergence_pnl_usd_value": "-9.92", "net_impermanent_loss_percentage": "-0.66", "unrealized_usd_value": "1482.71", "is_closed": false } } ``` ### Give an agent the same data as tool calls ›A hosted MCP server ›Uses your existing API key ›Billed and rate limited like direct API calls ›Structured tool calls, no scraping [See endpoints and pricing →](/products/api-platform) agent · defiorbitexample Is my Aave position on Base at risk of liquidation? tool call · Aave V3 position risk✓ 8 credits Your health factor is **1.42**. You have $5,085.89 in collateral against $2,854.38 of debt, for a net worth of $2,231.51. The collateral is WETH and WSTETH. 02 / How you would use it ## Three ways to build on the API Platform One key, one credit balance and one consistent schema behind all three. Call it ### REST endpoints LP position and lending data for any wallet, from a 1-credit summary to a full breakdown. Uniswap V3, Aerodrome and Orca positions Aave, Morpho and Kamino lending A fixed, published credit cost on every endpoint [See endpoints →](/products/api-platform#lp) Scale it ### Keys, batch and usage Run it in production with keys per environment and full visibility on spend. Batch requests for many wallets in one call Keys with rate limits and request logs Usage by endpoint, key and status code [See usage and logs →](/products/api-platform#usage) Give it to agents ### MCP server Expose the same endpoints to AI agents as read-only tools, with the same key. Works with Claude, Cursor and any MCP client Same credits and rate limits as the REST API No tool can move funds [See DeFi Orbit AI →](/products/defi-orbit-ai) 03 / In their words ## From the live API GET /v1/positions/uniswapv3/:id/yield8 credits ``` { "data": { "token_id": "119128", "chain_id": 130, "earned_apr_percentage": { "yield": "41.23", "fees": "41.23", "rewards": "0" }, "projected_yield_apr": "41.23", "estimated_total_yield": { "daily": "1.67", "weekly": "11.72", "monthly": "50.22", "yearly": "611.00" }, "total_fees": { "totalUsdValue": "12.10" }, "unclaimed_fees": { "totalUsdValue": "12.10" }, "total_yield": "49.88", "is_closed": false }, "request_id": "req_..." } ``` ## Questions builders ask Do I need my own RPC provider? Not for anything we return. We run the indexers and pay for the RPC calls behind every response, so you make one HTTPS request and get calculated positions back. You only need your own RPC if you're reading other contracts on top of our data. Is there a subscription? No. You buy a credit pack and spend credits per call, and purchased credits don't expire while your account is active. Every endpoint has a fixed, published cost between 1 and 30 credits, failed requests are free, and each response tells you what it cost, so there's no surprise at the end of the month. Which chains are supported? Ethereum, Base, Arbitrum, Optimism, Unichain, Polygon, BNB Smart Chain, Avalanche, Robinhood Chain and Solana. Coverage varies by protocol, so the Supported networks page shows exactly which deployments are live for each one. How do I get started, and how long does it take? Create an account on the platform, generate an API key and make your first call. The Starter pack is 500 credits for $10, enough to test every endpoint against real wallets before you decide. Most developers have data in their app the same afternoon. 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. Can I use this with AI agents or an LLM app? Yes. DeFi Orbit AI is a hosted MCP server with 54 read-only tools covering the same data as the API, on the same key and the same credits. Point your agent at it and it can query positions, fees and lending risk without you writing a tool layer. Compare solutions [All comparisons →](/compare) [ Build it yourself DeFi Orbit vs. building it in-house ](/compare/in-house)[ Indexing protocols DeFi Orbit vs. subgraphs ](/compare/subgraphs)[ Portfolio APIs DeFi Orbit vs. Zerion API ](/compare/zerion) ## Start building today. 500 credits for $10. [Get API key](https://platform.defiorbit.xyz)[Read the docs](#docs) × 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 ↗](#)