Notus API
Smart wallets

Get Smart Wallet Details

This endpoint retrieves the details of a user's smart wallet, including the date the wallet was registered with this project, or _null_ if it's not registered yet.

GET
/api/v1/wallets/{walletAddress}

Authorization

x-api-key<token>

In: header

Path Parameters

walletAddressstring

Public address of the Smart Wallet. This is where the funds remain and not the Externally Owned Account (EOA) that is the owner of the smart wallet.

Match^0x[a-fA-F0-9]{40}$

Response Body

curl -X GET "https://api.notus.team/api/v1/wallets/0x133700000000000000000000000000000000c0de"
{
  "wallet": {
    "metadata": {
      "key": "value"
    },
    "walletAddress": "0x6e397ddf51d9f15dbe0414538e7529f51f2e5464",
    "accountAbstraction": "0x6e397ddf51d9f15dbe0414538e7529f51f2e5464",
    "externallyOwnedAccount": "0x133700000000000000000000000000000000c0de",
    "factory": "0x0000000000400cdfef5e2714e63d8040b700bc24",
    "implementation": "0x8e8e658e22b12ada97b402ff0b044d6a325013c7",
    "eip7702": false,
    "deployed": [
      {
        "chain": {
          "id": 137,
          "name": "POLYGON",
          "logo": "https://logopolygon.com"
        },
        "deployed": true
      }
    ],
    "salt": 12345,
    "registeredAt": "2025-08-06T16:57:09.249Z"
  }
}
{
  "statusCode": 403,
  "id": "UNAVAILABLE_COMPUTE_UNITS",
  "message": "The project doesn't have enough compute units to perform this action. Please upgrade your plan."
}
{
  "statusCode": 404,
  "id": "PROJECT_NOT_FOUND",
  "message": "The provided project does not exist"
}

Get Smart Wallet GET

This endpoint retrieves the details of a user's smart wallet, including the date the wallet was registered with this project, or _null_ if it's not registered yet.

Get Smart Wallet Portfolio GET

Get the portfolio of a smart wallet by its account abstraction address. The portfolio is a list of the user's balances in different tokens.