Docs

Get Vault V1 target market reallocatable liquidity

Public API

T2 dynamic. Public Allocator V1 liquidity from canonical indexed shared reallocation routes. Vault and market selectors must use the same chain (400 otherwise). Unknown vault, unknown market, missing Public Allocator V1 deployment or a vault without that allocator enabled return 404. Vault-target pairs without a completed per-vault snapshot return 404 LIQUIDITY_NOT_COMPUTED, even if another vault has a snapshot for the target. Completed configured pairs with no capacity return zero and empty routes. At most 29 distinct source markets: MetaMorpho MAX_QUEUE_LENGTH is 30 including the target, which cannot be a source. Stored results exceeding 29 sources fail with 500, never truncate. The fee is a fixed native-token wei amount per reallocateTo call, not WAD or proportional; missing configuration means zero. Freshness is the minimum of the persisted calculation's simulation, realtime vault, allocation, market and oracle snapshot blocks and the stable indexer tips used by the calculation and endpoint. Event-derived flow caps, allocator assignments, market configuration and live PA configuration use their read checkpoint as vintage, not the blocks of their underlying events. PA configuration and flow-cap events are read live at or below that checkpoint; no-event defaults also use the checkpoint. Routes and provenance are loaded from one per-vault snapshot, isolated from legacy shared-liquidity writes and cleanup. Failed calculations retain the prior snapshot and its watermark.


GET
/v0/vaults-v1/{vault-selector}/markets/{market-selector}/reallocatable-liquidity

Vault selector example: 1:0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB (format: <chain_id>:<vault_address>; replace with the target vault).

Path Parameters

vault-selector*string

Selector formatted as <chain_id>:<vault_address>. Example: 1:0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB.

Format<chain_id>:<vault_address>
market-selector*string

Selector formatted as <chain_id>:<market_id>. Example: 1:0xfff1970c0ffae288764186fbb38a9171a17e98676744a1e345809cb8b9e73342.

Format<chain_id>:<market_id>

Response Body

application/json

curl -X GET "https://example.com/v0/vaults-v1/1:0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB/markets/1:0xfff1970c0ffae288764186fbb38a9171a17e98676744a1e345809cb8b9e73342/reallocatable-liquidity"
{  "data": {    "chain_id": 1,    "market_id": "string",    "public_allocator_address": "string",    "reallocatable_assets": "string",    "reallocation_fee_native": "string",    "routes": [      {        "chain_id": 1,        "reallocatable_assets": "string",        "withdraw_market_id": "string"      }    ]  },  "last_indexed_block": "string"}
Empty
Empty
Empty