List user V1 vault positions
Public APICursor-paginated discovery list of Morpho Vault V1 positions held by a user across exposed chains, including unlisted vaults. By default, only positions with non-zero shares are returned. With active_only=false, the list also returns zero-share rows for every vault in which the user has held shares, so a fully exited position stays discoverable with shares and assets of 0. Blacklisted vaults are the exception: their rows are removed from the index. Membership follows vault share Transfer events: a deposit is recorded for the share receiver, a withdrawal or redemption for the share owner, and a share transfer for both sender and recipient; an address that only sends assets on behalf of another receiver is not listed. Rows reflect the realtime position index, which is updated as those events are indexed; a position in a newly created vault appears once that vault itself has been indexed. Results can be filtered with chain_ids and vault_addresses. 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 V1 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-v1/users/0xabcdefabcdefabcdefabcdefabcdefabcdefabcd/positions"{ "cursor": null, "data": [ { "assets": "1004300000000000000000", "chain_id": 1, "last_indexed_block": "23481902", "shares": "980000000000000000000", "vault_address": "0x38989BBA00BDF8181F4082995b3DEAe96163aC5D" } ], "params": { "user_address": "0x821b0F1A2C3d4E5f6789aBcDeF0123456789AbCd" }}GETList V1 vaults
Cursor-paginated list of listed Morpho Vault V1 instances across every supported chain: identity, deployment facts, the performance-fee setup and the owner /…
GETGet V1 vault
Morpho Vault V1 configuration: identity (name, symbol, version), underlying asset, factory, fee setup, owner/curator/guardian roles, and timelock.