Docs

List user V2 vault positions

Public API

Cursor-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.


GET
/v0/vaults-v2/users/{user-address}/positions

Path Parameters

user-address*string

User address to list positions for. Lowercase input is checksummed. Example: 0xabcdefabcdefabcdefabcdefabcdefabcdefabcd.

Formataddress

Query Parameters

chain_ids?array<>

Comma-separated EVM chain identifiers to filter on. Defaults to every exposed chain.

Itemsitems <= 100
vault_addresses?array<>

Comma-separated vault addresses to filter on.

Itemsitems <= 100
active_only?string

When true, excludes positions with zero shares. Defaults to true.

Default"true"

Value in

  • "true"
  • "false"
sort_by?string

Sort field for cursor pagination.

Default"vault_address"

Value in

  • "vault_address"
  • "shares"
  • "assets"
sort_direction?string

Sort direction.

Default"desc"

Value in

  • "asc"
  • "desc"
limit?integer

Maximum number of positions to return.

Range1 <= value <= 100
Default100
cursor?string

Opaque 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.

Length1 <= length <= 4096

Response 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"  }}