List user V2 vault positions
Public APICursor-paginated discovery list of Morpho Vault V2 positions held by a user across exposed chains. By default, only positions with non-zero shares are returned. With active_only=false, the list also returns zero-share rows for vaults the user has fully exited, listed or not, so it lists every Morpho Vault V2 position the realtime service has tracked for the user. Rows belong to the share holder: a deposit credits its onBehalf address and a share transfer credits its recipient; a full withdrawal, redemption or transfer out leaves the row with zero shares and zero assets. Rows update when the realtime service processes the user's Vault V2 deposit, withdrawal or transfer events; a scheduled re-sync every 10 minutes catches recently indexed events the live path missed. It scans only about the last 15 minutes of blocks before the chain head, so an event indexed after that window can stay stale until the user's next Vault V2 event or a backfill. Results can be filtered with chain_ids and vault_addresses. Fee wrappers and vaults that are not Morpho Vault V2s are not listed. Blacklisted vaults are removed eventually rather than at request time: a cleanup job deletes their position rows when the realtime scheduler starts and then every hour, so a newly blacklisted vault can stay listed until the next run. Unsupported vault adapters can stop a row from being created or refreshed, so those positions may be missing or stale. Pagination is weakly consistent and not snapshot-isolated: continuation pages re-evaluate realtime state, so changes to shares, assets, active status or membership may omit or repeat rows. last_indexed_block is freshness metadata only, not a pagination snapshot. Rows use the same position item shape as the singular Vault V2 user-position endpoint.
Path Parameters
User address to list positions for. Lowercase input is checksummed. Example: 0xabcdefabcdefabcdefabcdefabcdefabcdefabcd.
addressQuery Parameters
Comma-separated EVM chain identifiers to filter on. Defaults to every exposed chain.
items <= 100Comma-separated vault addresses to filter on.
items <= 100When true, excludes positions with zero shares. Defaults to true.
"true"Value in
- "true"
- "false"
Sort field for cursor pagination.
"vault_address"Value in
- "vault_address"
- "shares"
- "assets"
Sort direction.
"desc"Value in
- "asc"
- "desc"
Maximum number of positions to return.
1 <= value <= 100100Opaque seek cursor (maximum 4096 characters) returned by a previous page. Do not modify it or parse it. It is unsigned and untrusted, not an authorization boundary; the user and filters are reapplied on every page, and changing the collection, sort, user or filters invalidates it.
1 <= length <= 4096Response Body
application/json
curl -X GET "https://example.com/v0/vaults-v2/users/0xabcdefabcdefabcdefabcdefabcdefabcdefabcd/positions"{ "cursor": null, "data": [ { "assets": "1312500000000000000000", "chain_id": 1, "last_indexed_block": "23481902", "shares": "1250000000000000000000", "vault_address": "0xBEEFcf0BA6b4a04AB8C5B2Dd1E5c5F0E2A5F64CB" } ], "params": { "user_address": "0x821b0F1A2C3d4E5f6789aBcDeF0123456789AbCd" }}GETList V2 vaults
Cursor-paginated discovery list of the listed Morpho Vault V2 instances across all exposed chains. Reference for GET /v0/vaults-v2 in the Morpho Core API.
GETGet V2 vault
Morpho Vault V2 configuration: identity, underlying asset, factory, management/performance fees, owner and curator roles, per-function timelocks and…