Error
A valid request URL is required to generate request examples{
"data": {
"chainId": 1,
"blockNumber": 26147329,
"vaults": [
{
"slug": "stable-vault",
"name": "Stable Vault",
"symbol": "USDst",
"status": "active",
"address": "0xcDA323c2DF692d989B24BA51D0aCCa924cf9a344",
"asset": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"symbol": "USDC",
"decimals": 6
},
"apy": {
"value": 3.5552,
"source": "live"
},
"netApr": {
"d7": 3.6482,
"d30": 3.5552,
"inception": 3.5552
},
"onchain": {
"shareDecimals": 18,
"totalAssets": "2520805577613",
"totalSupply": "2514206304824688802868371",
"sharePrice": "1002624",
"tvlUsd": 2520805.577613,
"depositCap": null,
"fees": {
"managementBps": 0,
"performanceBps": 0,
"entryBps": 0,
"exitBps": 0,
"haircutBps": 0
},
"paused": false,
"navValid": true,
"syncMode": "sync_deposit",
"asyncOnly": false
},
"operations": {
"depositsOpen": true,
"lifecycle": "open"
}
},
{
"slug": "balanced-vault",
"name": "Balanced Vault",
"symbol": "USDbl",
"status": "active",
"address": "0xA5AE405242f42C47996a0C6857ff10a77F9bdeE6",
"asset": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"symbol": "USDC",
"decimals": 6
},
"apy": {
"value": 7.456,
"source": "live"
},
"netApr": {
"d7": 7.2334,
"d30": 7.456,
"inception": 7.456
},
"onchain": {
"shareDecimals": 18,
"totalAssets": "209334602655",
"totalSupply": "208177770987510665372408",
"sharePrice": "1005556",
"tvlUsd": 209334.602655,
"depositCap": null,
"fees": {
"managementBps": 0,
"performanceBps": 0,
"entryBps": 0,
"exitBps": 0,
"haircutBps": 0
},
"paused": false,
"navValid": true,
"syncMode": "sync_deposit",
"asyncOnly": false
},
"operations": {
"depositsOpen": true,
"lifecycle": "open"
}
},
{
"slug": "boosted-vault",
"name": "Boosted Vault",
"symbol": "USDbt",
"status": "active",
"address": "0x9E0DB8F43bb91e2148B0Db920E21370525CF3Aab",
"asset": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"symbol": "USDC",
"decimals": 6
},
"apy": {
"value": 10.1855,
"source": "live"
},
"netApr": {
"d7": 9.8396,
"d30": 10.1855,
"inception": 10.1855
},
"onchain": {
"shareDecimals": 18,
"totalAssets": "436234529471",
"totalSupply": "433355326583650535453892",
"sharePrice": "1006643",
"tvlUsd": 436234.529471,
"depositCap": null,
"fees": {
"managementBps": 0,
"performanceBps": 0,
"entryBps": 0,
"exitBps": 0,
"haircutBps": 0
},
"paused": false,
"navValid": true,
"syncMode": "sync_deposit",
"asyncOnly": false
},
"operations": {
"depositsOpen": true,
"lifecycle": "open"
}
}
]
},
"asOf": 1791458270
}{
"error": "The request is not valid. See details.",
"code": "invalid_request",
"requestId": "a5ba5c77-7339-4e12-b2cf-3c1f848f8da8",
"details": [
{
"path": "body.foo",
"issue": "is not a known field"
}
]
}{
"error": "Unauthorized.",
"code": "unauthorized",
"requestId": "ea80702c-a332-4e32-922e-76bcb02e6156"
}{
"error": "The request body is too large.",
"code": "payload_too_large",
"requestId": "0c8e5a7d-3f21-4b96-a4d8-7e1b9c2f6a30"
}{
"error": "Send the request body as application/json.",
"code": "unsupported_media_type",
"requestId": "9b4f6e2a-1c7d-4a85-8e3f-5d0a2b6c9e17"
}{
"error": "Too many requests. Wait and try again.",
"code": "rate_limited",
"requestId": "8e2f4a6c-1b3d-4e5f-9a7b-0c2d4e6f8a1b"
}{
"error": "An unexpected error occurred.",
"code": "internal_error",
"requestId": "4a7c9e1f-6b2d-4f83-9c05-8e3a1d7b2f64"
}{
"error": "An upstream data source returned an error.",
"code": "upstream_error",
"requestId": "2e6b8d4f-9a13-4c57-b8e2-1f7c3a5d9b06"
}{
"error": "The service is temporarily unavailable.",
"code": "service_unavailable",
"requestId": "7d3a1f9c-5e82-4b06-a3c7-9f2e6b4d1a58"
}{
"error": "An upstream data source did not respond in time.",
"code": "upstream_timeout",
"requestId": "5c9e3b7a-2d64-4f18-b7a9-3e1d8c6f2b40"
}{
"error": "<string>",
"code": "invalid_request",
"requestId": "<string>",
"details": [
{
"path": "<string>",
"issue": "<string>"
}
]
}Vaults
List vaults
Every public Kamui vault with its live state, in the order the Kamui app lists them. Send an empty JSON object.
onchainis read at one block (blockNumber): total assets and supply, the price of one share, TVL, the deposit cap, the fees, and the paused, NAV and sync-mode flags. Amounts are base-unit integer strings.apy.valueis the 30-day net APR from Lagoon (source: "live"), or the target set by Kamui (source: "target") while the live value is unavailable.netAprgives the live 7-day, 30-day and since-inception values, or null when one is unavailable:d7is null when the vault’s NAV was not updated in the last 7 days.operations.depositsOpenis true when a synchronous deposit is accepted now.operations.lifecyclecomes from Lagoon’s indexer and can lag the chain by a few minutes. When it is null, only the onchain flags decidedepositsOpen.- A coming-soon vault has no address, no
onchainstate and no live APR. - If Lagoon is unavailable, the request still answers:
apyfalls back to the target, andnetAprandlifecycleare null. - If the chain read fails, the request fails (502, 503 or 504) rather than return partial state.
POST
/
vaults.list
Error
A valid request URL is required to generate request examples{
"data": {
"chainId": 1,
"blockNumber": 26147329,
"vaults": [
{
"slug": "stable-vault",
"name": "Stable Vault",
"symbol": "USDst",
"status": "active",
"address": "0xcDA323c2DF692d989B24BA51D0aCCa924cf9a344",
"asset": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"symbol": "USDC",
"decimals": 6
},
"apy": {
"value": 3.5552,
"source": "live"
},
"netApr": {
"d7": 3.6482,
"d30": 3.5552,
"inception": 3.5552
},
"onchain": {
"shareDecimals": 18,
"totalAssets": "2520805577613",
"totalSupply": "2514206304824688802868371",
"sharePrice": "1002624",
"tvlUsd": 2520805.577613,
"depositCap": null,
"fees": {
"managementBps": 0,
"performanceBps": 0,
"entryBps": 0,
"exitBps": 0,
"haircutBps": 0
},
"paused": false,
"navValid": true,
"syncMode": "sync_deposit",
"asyncOnly": false
},
"operations": {
"depositsOpen": true,
"lifecycle": "open"
}
},
{
"slug": "balanced-vault",
"name": "Balanced Vault",
"symbol": "USDbl",
"status": "active",
"address": "0xA5AE405242f42C47996a0C6857ff10a77F9bdeE6",
"asset": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"symbol": "USDC",
"decimals": 6
},
"apy": {
"value": 7.456,
"source": "live"
},
"netApr": {
"d7": 7.2334,
"d30": 7.456,
"inception": 7.456
},
"onchain": {
"shareDecimals": 18,
"totalAssets": "209334602655",
"totalSupply": "208177770987510665372408",
"sharePrice": "1005556",
"tvlUsd": 209334.602655,
"depositCap": null,
"fees": {
"managementBps": 0,
"performanceBps": 0,
"entryBps": 0,
"exitBps": 0,
"haircutBps": 0
},
"paused": false,
"navValid": true,
"syncMode": "sync_deposit",
"asyncOnly": false
},
"operations": {
"depositsOpen": true,
"lifecycle": "open"
}
},
{
"slug": "boosted-vault",
"name": "Boosted Vault",
"symbol": "USDbt",
"status": "active",
"address": "0x9E0DB8F43bb91e2148B0Db920E21370525CF3Aab",
"asset": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"symbol": "USDC",
"decimals": 6
},
"apy": {
"value": 10.1855,
"source": "live"
},
"netApr": {
"d7": 9.8396,
"d30": 10.1855,
"inception": 10.1855
},
"onchain": {
"shareDecimals": 18,
"totalAssets": "436234529471",
"totalSupply": "433355326583650535453892",
"sharePrice": "1006643",
"tvlUsd": 436234.529471,
"depositCap": null,
"fees": {
"managementBps": 0,
"performanceBps": 0,
"entryBps": 0,
"exitBps": 0,
"haircutBps": 0
},
"paused": false,
"navValid": true,
"syncMode": "sync_deposit",
"asyncOnly": false
},
"operations": {
"depositsOpen": true,
"lifecycle": "open"
}
}
]
},
"asOf": 1791458270
}{
"error": "The request is not valid. See details.",
"code": "invalid_request",
"requestId": "a5ba5c77-7339-4e12-b2cf-3c1f848f8da8",
"details": [
{
"path": "body.foo",
"issue": "is not a known field"
}
]
}{
"error": "Unauthorized.",
"code": "unauthorized",
"requestId": "ea80702c-a332-4e32-922e-76bcb02e6156"
}{
"error": "The request body is too large.",
"code": "payload_too_large",
"requestId": "0c8e5a7d-3f21-4b96-a4d8-7e1b9c2f6a30"
}{
"error": "Send the request body as application/json.",
"code": "unsupported_media_type",
"requestId": "9b4f6e2a-1c7d-4a85-8e3f-5d0a2b6c9e17"
}{
"error": "Too many requests. Wait and try again.",
"code": "rate_limited",
"requestId": "8e2f4a6c-1b3d-4e5f-9a7b-0c2d4e6f8a1b"
}{
"error": "An unexpected error occurred.",
"code": "internal_error",
"requestId": "4a7c9e1f-6b2d-4f83-9c05-8e3a1d7b2f64"
}{
"error": "An upstream data source returned an error.",
"code": "upstream_error",
"requestId": "2e6b8d4f-9a13-4c57-b8e2-1f7c3a5d9b06"
}{
"error": "The service is temporarily unavailable.",
"code": "service_unavailable",
"requestId": "7d3a1f9c-5e82-4b06-a3c7-9f2e6b4d1a58"
}{
"error": "An upstream data source did not respond in time.",
"code": "upstream_timeout",
"requestId": "5c9e3b7a-2d64-4f18-b7a9-3e1d8c6f2b40"
}{
"error": "<string>",
"code": "invalid_request",
"requestId": "<string>",
"details": [
{
"path": "<string>",
"issue": "<string>"
}
]
}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
The body is of type object.