Docs

Get Vault V2 target-market reallocatable liquidity

Public API

Tier: T2 dynamic. Public Allocator V2 capacity into one Blue market, filtered from the canonical full composition so competing vaults share constraints. The full composition is cached for 10 seconds per chain, allocator and target market; concurrent fills are deduplicated across vault requests. Penalty settings are read per request. Both selectors must use the same chain; invalid selectors or a chain mismatch return 400. Unknown vaults return 404. Markets absent from indexer configuration return 404 with message 'Unknown market'; an existing market without Midx target-market state returns retryable 503. Missing chain deployment, current allocator assignment or current target-market configuration returns 404 with message 'No Public Allocator V2 configuration'. Historical setters for other markets do not qualify. Configured zero-capacity pairs return 200 with no routes and the configured proportional penalty. Unsupported adapters or funded vaults outside the top-20 simulated set return distinct 501 errors, never zero capacity. Incomplete Midx vault state returns retryable 503. Freshness is bounded by the cached composition's own starting indexer head, every contributing Midx snapshot block and the request's starting head. Forward indexer progress never raises cached freshness. Rollback below the composition's starting head or the request's starting head returns retryable 503. Routes are bounded to 200 distinct source/target cap pairs by the composer SDK-cardinality guard; an exceeded bound fails closed with 500, never truncates.


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

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

Path Parameters

vault-selector*string

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

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-v2/1:0x23f5E9c35820f4baB695Ac1F19c203cC3f8e1e11/markets/1:0xfff1970c0ffae288764186fbb38a9171a17e98676744a1e345809cb8b9e73342/reallocatable-liquidity"
{  "data": {    "chain_id": 8453,    "market_id": "0x1111111111111111111111111111111111111111111111111111111111111111",    "penalty_wad": "10000000000000000",    "public_allocator_address": "0x1111111111111111111111111111111111111111",    "reallocatable_assets": "600000000000",    "routes": [      {        "chain_id": 8453,        "reallocatable_assets": "500000000000",        "source_adapter_address": "0x2222222222222222222222222222222222222222",        "source_type": "market",        "target_adapter_address": "0x3333333333333333333333333333333333333333",        "withdraw_market_id": "0x2222222222222222222222222222222222222222222222222222222222222222"      },      {        "reallocatable_assets": "100000000000",        "source_type": "idle",        "target_adapter_address": "0x3333333333333333333333333333333333333333"      }    ]  },  "last_indexed_block": "25475347"}
Empty
Empty