ReferenceAPI ReferenceWallet

List wallet anchors

GET/wallets/{id}/anchors●Retrieve anchors linked to a wallet.

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.

GET
/wallets/{id}/anchors

Usage Examples

curl -X GET "http://localhost:3000/v2/wallets/string/anchors" \  -H "x-ledger: <YOUR LEDGER HANDLE>"
{
  "hash": "349215864c5972a1b48cdc791f575d611d08bb9829dfe177d28ab33f38e12f28",
  "data": [
    {
      "luid": "$anc.-01xK2cTuV3dS4xY3",
      "hash": "b907d26c8dc13a9f147ddf61412ec0690befbe5389b491fb8a132b2e7560df87",
      "data": {
        "handle": "tel:+1234567890",
        "wallet": "tesla-bank-wallet",
        "target": "svgs:1001001234@tesla-bank.com",
        "symbol": "usd",
        "custom": {
          "name": "John Doe",
          "entityType": "individual"
        }
      },
      "meta": {
        "moment": "2025-04-05T14:30:00.520Z",
        "proofs": [
          {
            "signer": "system",
            "method": "ed25519-v2",
            "digest": "6ab5772cc1cf45af4c943bcbd49704b1a27f2cff20d05c8946ec1949bdbcf041",
            "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
            "result": "XdDctHONO7mPP4rNK47jff4kfT452fjd2cF+Z3pqImVlyW0XlDGK/SPfVR4m1rDjsVml8MQqYVAwFi9C/PHwBQ==",
            "custom": {
              "luid": "$anc.-01xK2cTuV3dS4xY3",
              "moment": "2025-04-05T14:30:00.520Z"
            }
          }
        ]
      }
    }
  ],
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "99cc95b4a6e80ef5e3f7c838042ef9366118f8fa5179e5b4277f5cd1cc0c8397",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "XVF5wbVsfoFMiuNC8oPbEoSJk5jae1v5SFYoNXvELGFX/8Bm6HCT60BSQtkX3kO1QMoItUx/NEPL0ARYlF6JDQ==",
        "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).

Query Parameters

page?

Pagination options. Set limit and index to page through results.

filter?

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 limits GET

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.

Lookup wallet anchors POST

Searches anchors linked to this wallet using filters provided in the request body. If the wallet has a bridge assigned with the `anchors` trait, the lookup is forwarded to the bridge.