Docs

List user V1 vault positions

Public API

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


GET
/v0/vaults-v1/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-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"  }}