Error
A valid request URL is required to generate request examples{
"data": {
"address": "0x1111111111111111111111111111111111111111",
"chainId": 1,
"blockNumber": 26124800,
"totals": {
"valueUsd": 1002.182,
"pendingDepositsUsd": 0,
"claimableDepositsUsd": 0,
"pendingRedemptionsUsd": 250.5455,
"claimableRedemptionsUsd": 0
},
"positions": [
{
"vault": {
"slug": "balanced-vault",
"address": "0xA5AE405242f42C47996a0C6857ff10a77F9bdeE6"
},
"shares": "1000000000000000000000",
"valueAssets": "1002182000",
"valueUsd": 1002.182,
"pendingDeposit": {
"assets": "0"
},
"claimableDeposit": {
"assets": "0",
"shares": "0",
"valueAssets": "0"
},
"pendingRedeem": {
"shares": "0",
"estimatedAssets": "0"
},
"claimableRedeem": {
"shares": "0",
"assets": "0"
}
},
{
"vault": {
"slug": "stable-vault",
"address": "0xcDA323c2DF692d989B24BA51D0aCCa924cf9a344"
},
"shares": "0",
"valueAssets": "0",
"valueUsd": 0,
"pendingDeposit": {
"assets": "0"
},
"claimableDeposit": {
"assets": "0",
"shares": "0",
"valueAssets": "0"
},
"pendingRedeem": {
"shares": "250000000000000000000",
"estimatedAssets": "250545500"
},
"claimableRedeem": {
"shares": "0",
"assets": "0"
}
}
]
},
"asOf": 1791454901
}Users
Get wallet positions
Positions of one wallet in every active vault, read at one block (blockNumber).
- Each amount sits in exactly one bucket: held shares (
shares,valueAssets), a deposit waiting for settlement (pendingDeposit), a settled deposit whose shares are not claimed yet (claimableDeposit), a redeem request waiting for settlement (pendingRedeem, estimated at the current share price), and a settled redeem request ready to claim (claimableRedeem). totalssums the buckets over all vaults in USD.- Vaults where the wallet holds less than $0.01 and has nothing in flight are left out, so a wallet with no position answers an empty
positionslist. - The response contains no onboarding, consent or contact data.
POST
/
users.positions
Error
A valid request URL is required to generate request examples{
"data": {
"address": "0x1111111111111111111111111111111111111111",
"chainId": 1,
"blockNumber": 26124800,
"totals": {
"valueUsd": 1002.182,
"pendingDepositsUsd": 0,
"claimableDepositsUsd": 0,
"pendingRedemptionsUsd": 250.5455,
"claimableRedemptionsUsd": 0
},
"positions": [
{
"vault": {
"slug": "balanced-vault",
"address": "0xA5AE405242f42C47996a0C6857ff10a77F9bdeE6"
},
"shares": "1000000000000000000000",
"valueAssets": "1002182000",
"valueUsd": 1002.182,
"pendingDeposit": {
"assets": "0"
},
"claimableDeposit": {
"assets": "0",
"shares": "0",
"valueAssets": "0"
},
"pendingRedeem": {
"shares": "0",
"estimatedAssets": "0"
},
"claimableRedeem": {
"shares": "0",
"assets": "0"
}
},
{
"vault": {
"slug": "stable-vault",
"address": "0xcDA323c2DF692d989B24BA51D0aCCa924cf9a344"
},
"shares": "0",
"valueAssets": "0",
"valueUsd": 0,
"pendingDeposit": {
"assets": "0"
},
"claimableDeposit": {
"assets": "0",
"shares": "0",
"valueAssets": "0"
},
"pendingRedeem": {
"shares": "250000000000000000000",
"estimatedAssets": "250545500"
},
"claimableRedeem": {
"shares": "0",
"assets": "0"
}
}
]
},
"asOf": 1791454901
}Authorizations
The client's own API key (kmi_<id>_<secret>), issued by Kamui. A missing, malformed, unknown, revoked or expired key answers 401 unauthorized.
Headers
Your id for this request: 1 to 128 letters, digits, ., _, : or -. It is echoed in the response. Any other value is replaced with a new UUID.
Pattern:
^[A-Za-z0-9._:-]{1,128}$Body
application/json
Ethereum address: 0x and 40 hex characters, in lowercase or with a valid EIP-55 checksum. Other mixed case, all-uppercase hex, a 0X prefix and the zero address answer 400.
Required string length:
42Pattern:
^0x[0-9a-fA-F]{40}$