Get an LP's position in an asset vault
Returns an LP's full position in one asset vault as a set of buckets (free, deployed, locked) plus withdrawability, so the UI never offers a withdraw the vault would refuse. By default the free principal is reconciled against the vault's own on-chain value and both numbers are reported.
Authorization
ApiKeyAuth In: header
Path Parameters
Numeric ID of the chain to query or act on.
The vault's underlying asset, as a token contract address (0x-prefixed).
The liquidity provider's wallet address.
Query Parameters
Optional, defaults to true. When true, the reported free-principal balance is cross-checked against a live on-chain read, and set to false to skip the extra read.
Response Body
application/json
curl -X GET "https://example.com/api/vaults/positions/string/string/string"{ "position": { "chainId": 0, "vault": "string", "lp": "string", "principal": "string", "credit": "string", "deployed": "string", "frontHeld": "string", "asyncHeld": "string", "realizedLossDeployLeg": "string", "realizedLossReturnLeg": "string", "freePrincipal": "string" }, "fleetLive": true, "reconciliation": { "matched": true, "onChainFreePrincipal": "string", "indexedFreePrincipal": "string", "driftAbs": "string" }, "rpcDegraded": true}Check whether an LP can lock liquidity into a vault
Reports whether an LP can lock liquidity into an asset vault and, if not, why (for example the vault is paused or not deployed), plus the maximum lockable amount and any gates. Locking is permissionless, so this lets the UI disable the button with a reason instead of paying gas to discover a revert.
Get all of an LP's positions on a chain in one call (batched multicall)
Returns every vault position for one LP on one chain, each with its freePrincipal reconciled against the vault's own on-chain value. Use this instead of one call per vault.