List wallet limits
GET/wallets/{id}/limits●Retrieve balance limits configured for a wallet.
Returns limits applied to the wallet such as minBalance,
maxBalance, dailyAmount, and dailyCount. Limits are set
through intent claims with the limit action.
Limit amounts follow the same integer format as balances — divide by the symbol's factor to get the decimal value.
Usage Examples
curl -X GET "http://localhost:3000/v2/wallets/string/limits" \ -H "x-ledger: <YOUR LEDGER HANDLE>"{
"hash": "a691a97f50f84f3628e094654a8c5978f48536d10f755ef036b2208cf886ab04",
"data": [
{
"luid": "$lmt.-01xK1bStU2cR3wX2",
"hash": "0582abcb4e9bfe82192b261f4c2773a956035ffd53135852991428f74e872af9",
"data": {
"wallet": "tesla-bank-wallet",
"symbol": "usd",
"amount": 0,
"metric": "minBalance"
},
"meta": {
"moment": "2025-04-05T14:30:00.510Z",
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "14dc7b0cb70cd380ca5a79f1ab84dea499a0f65096c6bddcdf46cbc54b05eeca",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "7+O8nk9HpuUWwWTCcqk808fCzpv+OMKhQQ5TXHlsMYh8q/wEnsfILeD4o7TDvutxTk++Qzg2xYiDQ14XvvGpBg==",
"custom": {
"luid": "$lmt.-01xK1bStU2cR3wX2",
"moment": "2025-04-05T14:30:00.510Z"
}
}
]
}
},
{
"luid": "$lmt.-01xK1bStU2cR3wX3",
"hash": "8ccdbda697141862d062c1aa8b86b75491e16f7d6553873bf1aa747daedddb46",
"data": {
"wallet": "tesla-bank-wallet",
"symbol": "usd",
"amount": 10000000,
"metric": "maxBalance"
},
"meta": {
"moment": "2025-04-05T14:30:00.515Z",
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "05092581baf9fceec703fe66aad4721bc7c2f17a5c43ceb29997f2183b82bc1b",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "MgU2I1TJAKiOnpTtp5S7RPCfYJiDLJk3fXAPUnkaiB7EpKSdsaenCXli6y1Vjv5Fk6WOliCiwujOHR/xxuH7AA==",
"custom": {
"luid": "$lmt.-01xK1bStU2cR3wX3",
"moment": "2025-04-05T14:30:00.515Z"
}
}
]
}
}
],
"page": {
"index": 0,
"limit": 20
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "5b9d01b6d7f2825ffd7c98e208d51b2c9456e9d5435c0a96d67dd3400116f163",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "yZwPkM0mB9x2+KQbZyEiGQCv1zH7ukj6j59+tspnbIitAr9Ym3sqAdotcdGGtIgo33hp9H7FIp6uFgU51qpnBg==",
"custom": {
"moment": "2025-04-05T14:30:00.100Z"
}
}
]
}
}{
"hash": "b7eb7ccf5ffc126951e13e29a8dcfdaf95db859715d4edfc2d16f59a79d4cd58",
"data": {
"reason": "auth.unauthorized",
"detail": "Invalid token."
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "3acece870c4118bfe4223118e4d2f3cfd5b8947a7093785b66d49aa57fa2890a",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "gnK63DqqWDY/UXvnZHixDKPKS6tfeGHgdARylnPiJLwQGyYxuD97TYbSg2wrzsf/bDrHwQYZaf8Gu5ryYP0UAA==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "9ec02726b50650add8acfd124c6defeb978a9ac252a5de888f9493ddc701e927",
"data": {
"reason": "auth.forbidden",
"detail": "Request is not authorized"
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "4f8cbdc38d73348de0c31805c783c84a0fecc6be736d7e187004ba68cd00e675",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "P3hRnveehtuobb4AIO56XBmiduvmYJbpdmOHltG/IifBEH7QSWdv/0pqled4SO9x1Ne3oXuWxJy40DzMvx1MBA==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "d6c59a6df7165fa4a75159799ca5f5e26e544cbb8769eced3d35d8021f6f7935",
"data": {
"reason": "record.not-found",
"detail": "Signer not found"
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "78cf86f34aefcf9da6ed4167a38aac0a2739f68f7bafb1d3e033c01ed1b6cdf1",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "9Ledk+/iAAtj+uLjGe2afq4kID7n8UQD6UpRpLBCujxFjxddq0uZ2tnYRTAXmYdHDkbF0uXqtNM9qO3xhEtpAA==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "1c084e8dcfb9bb84bc8ea96e9e137b149a34b2bbd85f8e60b4263f5aba980476",
"data": {
"custom": {
"errors": [
{
"instancePath": "/handle",
"schemaPath": "#/properties/handle/pattern",
"keyword": "pattern",
"params": {
"pattern": "^[a-zA-Z0-9_\\-+.]+$"
},
"message": "must match pattern \"^[a-zA-Z0-9_\\-+.]+$\""
}
]
},
"reason": "record.schema-invalid",
"detail": "Schema validator error: data.handle must match pattern \"^[a-zA-Z0-9_\\-+.]+$\""
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "7a5febb431719b6f43d7e88e79211308e16ac651b71b339276373fdb4e7c3760",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "2/1zYw4AaIzsIHfOIC6V/CHw6owbjYHt48cwmFOig0ibeT0IbojLmj1RCRi8W00ka0udPa9WsacWDd7ObMY8CA==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "93a5f4d97a42c2df97f827c58ff7768d02568c15aca931e22b81fa3160ba0df3",
"data": {
"reason": "api.unexpected-error",
"detail": "An unexpected error occurred"
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "efaf5360143b586917d9636779ad6e08571c5b06909a20dd0f5eba4bf3be7eae",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "hERh6Aecj59iR+Fb25OQsHJScOi4t8EiffKSfjlMQdjHMccTnfDlgZFdaJzXzUtpSwy/NHq0l+7ydh3HSWCoAg==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}Path Parameters
id*|
The unique identifier of the wallet record - it is luid or handle (address).
Header Parameters
x-ledger?|
The unique identifier of ledger in context for multi tenant requests.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
List wallet balances GET
Returns all balances held by this wallet across symbols. A wallet can hold balances in multiple currencies or units of exchange simultaneously. Only symbols that have had balance activity are returned — symbols with no prior transactions will not appear with a zero balance. Balances are returned as integers in the smallest unit defined by the symbol's factor. Divide the balance by the factor to get the decimal value. For example, a balance of `1550` with a symbol factor of `100` represents `15.50`.
List wallet anchors GET
Returns anchors linked to this wallet. If the wallet has a bridge assigned with the `anchors` trait, the query is forwarded to the bridge instead of the local database.