{"uid":"cap__uXhOmVyMk2UEBDi7_1ba","slug":"ozmium-positions-api-defi-position-lookup-for-base-address-c35558ac","name":"Ozmium Positions API – DeFi Position Lookup for Base Address","description":"Live Morpho Blue borrow positions (collateral, debt, health factor, liquidation distance), Morpho vault deposits (APY, earnings), Gains Network open leveraged trades (pair, direction, leverage, entry, TP/SL), and on-chain PENDING orders (incl. stranded market orders the keyless backend hides) for any Base address. GET /v1/positions/{address}.","url":"https://ozmium.org/v1/positions/:address","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","properties":{"address":{"type":"string"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"risk":{"type":"array","items":{"type":"object","properties":{"long":{"type":"boolean"},"leverage":{"type":"number"},"pairIndex":{"type":"number"}}}},"address":{"type":"string"}}},"network":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1qhARn77HY2NvSXydnYJ3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live Morpho Blue borrow positions, Morpho vault deposits, Gains Network open leveraged trades, and pending on-chain orders for a given Base wallet address.","exampleAgentPrompt":"Pull up all my open DeFi positions on Base for wallet 0x1234...abcd — I want to see my Morpho Blue collateral, debt, and health factor, plus any open Gains Network leveraged trades with their entry prices and liquidation distances.","exampleUseCases":null,"resultDescription":"A JSON object keyed by address and network containing: an array of Morpho Blue borrow positions (collateral, debt, health factor, liquidation distance), Morpho vault deposit details (APY, cumulative earnings), an array of Gains Network open trades (pair index, long/short direction, leverage, entry price, TP/SL), and any on-chain pending orders including stranded market orders not surfaced by the keyless backend.","failureModes":["Invalid or malformed Base address returns a 400 error","Address with no positions returns an empty arrays response","Address on an unsupported network returns empty or network error","Upstream RPC or subgraph unavailability causes 503 or timeout","x402 payment not provided or insufficient returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a unified, live snapshot of a Base wallet's DeFi risk exposure across Morpho Blue (lending/borrowing) and Gains Network (perpetual leveraged trading) in a single call, especially when you need to surface pending or stranded orders that the Gains Network keyless backend conceals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:36:10.562Z","isFirstParty":false}