Notus API
Smart wallets

Get Smart Wallet

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/address

Authorization

x-api-key<token>

In: header

Query Parameters

externallyOwnedAccountstring

Public address of the Externally Owned Account (EOA) that will sign the transactions, the owner of the account abstraction wallet.

factorystring

The address of the factory contract that creates the account abstraction wallet contract.

See Factory Compatibility for the supported factory values and their EIP-7702 support.

salt?string

The salt number used to generate this wallet. If none is given the default is zero. Each salt generates a new smart wallet for the same user. The salt can be used for the following purposes:

  • Generating multiple smart wallets for the same user
    You can use this to have different portfolios in different wallets or any other reason
  • Getting a specific address for the smart wallet
    You can create a script that will test multiple salt values until a certain sequence of numbers show up in the smart wallet contract address. This way you can use the salt to make all smart wallet addresses you generate start with the initials of your company. Though you are limited to Hexadecimal digits, so you'll have to use Hexspeak.
eip7702?boolean

Whether you want to deploy using the EIP7702 standard, that lets the EOA set a contract as its own contract code. The default value is False. See Factory Compatibility to check which factories support EIP7702. Salt has no effect and having it is disallowed.

Response Body

curl -X GET "https://api.notuslabs.xyz/api/v1/wallets/address?externallyOwnedAccount=0x133700000000000000000000000000000000c0de&factory=0x0000000000400cdfef5e2714e63d8040b700bc24&salt=12345&eip7702=false"
{
  "wallet": {
    "metadata": {
      "key": "value"
    },
    "walletAddress": "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": 400,
  "id": "FACTORY_NOT_SUPPORTED",
  "message": "This factory (0xd053b51a81b7306e7e2e34bfd4d51143da8dcdcc) is not yet supported, contact support to request its inclusion"
}
{
  "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"
}

Request Tax Transactions Export POST

Request a tax transactions export for a wallet. The report will be generated by an external tax API and sent to the provided email address.

Get Smart Wallet Details 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.