Docs

User V1 vault position performance

Realized + unrealized earnings of a user's Morpho Vault V1 position. Uses the average_cost accounting method: per-user share-price differentials are accumulated against the running share balance, with transfers netted into the same balance so that earnings reflect the user's economic exposure rather than their on-chain transaction count. return_on_capital is the time-weighted ratio of net earnings to capital deployed over the holding period (non-annualised). When as_of_date is set, the cutoff is the start of that UTC day. For an open position, valuation uses the last hourly share-price history point or the user's last position change, whichever is later, at or before the cutoff; it is not block-exact. as_of.timestamp is the effective valuation timestamp. For a position fully exited before the cutoff it is the last position change and the value is final. Invalid or future dates and unsupported chains return 400; unavailable history returns 503 or 404.


GET
/v0/vaults-v1/{vault-selector}/users/{user-address}/position/performance

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

Path Parameters

user-address*string

Position owner address. Example: 0xabcdefabcdefabcdefabcdefabcdefabcdefabcd.

Formataddress
vault-selector*string

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

Format<chain_id>:<vault_address>

Query Parameters

as_of_date?string

UTC calendar date in YYYY-MM-DD format; returns performance through 00:00:00Z on that date. Future dates are not supported.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatdate

Response Body

application/json

curl -X GET "https://example.com/v0/vaults-v1/1:0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB/users/0xabcdefabcdefabcdefabcdefabcdefabcdefabcd/position/performance"
{  "data": {    "accounting_method": "average_cost",    "chain_id": 1,    "last_indexed_block": "25475347",    "net_earnings_assets": "0",    "return_on_capital": null,    "user_address": "0xABcdEFABcdEFabcdEfAbCdefabcdeFABcDEFabCD",    "vault_address": "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"  }}