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.
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. Checks eligibility for a specific deposit size, in the asset's smallest unit (e.g. wei for an 18-decimal token).
Response Body
application/json
curl -X GET "https://example.com/api/vaults/string/string/deposit-eligibility/string"{ "eligible": true, "reason": "VAULT_PAUSED", "message": "string", "maxDepositable": "string", "gates": { "paused": true }, "globalCap": { "capUsd": 0, "usedUsd": 0, "remainingUsd": 0 }, "vault": "string", "fleetLive": true, "rpcDegraded": true}Get an LP's vault deposit and withdrawal history
Returns the wallet's vault deposits and withdrawals, newest first, with each withdrawal split between principal returned and credit claimed. Omit chainId to cover every chain on the surface, and page with the returned cursor.
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.