RHrhinestonewtf
Accounts

Register an account

Changed on

Registers a smart account for deposits. Registration is idempotent for the registered project and destination: an existing address cannot be reassigned to another project, account kind, chain, token, or recipient. To change destination, derive and register a new address. User-owned registration is limited to enabled organizations; others register managed accounts with POST /register-managed.

post/register

Request

Headers

x-api-keystring

API key for authentication

Example:your-api-key
x-api-versionstring

API version identifier (e.g. "2026-04.amazon"). Optional today, will become required in a future release.

Example:2026-04.amazon

Request body

Example request

{
  "account": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
    "accountParams": {
      "factory": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
      "factoryData": "0x1234abcd",
      "sessionDetails": {
        "hashesAndChainIds": [
          {
            "chainId": 1,
            "sessionDigest": "0x1234abcd"
          }
        ],
        "signature": "0x1234abcd"
      }
    },
    "target": {
      "chain": "eip155:8453",
      "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "outputTokenRules": [
        {
          "match": {
            "symbol": "USDC"
          },
          "outputToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        },
        {
          "match": {
            "chain": "eip155:10",
            "symbol": "ETH"
          },
          "outputToken": "0x0000000000000000000000000000000000000000"
        }
      ],
      "rejectUnmapped": true
    }
  }
}

Response

Account registered successfully

evmDepositAddressstring required
solanaDepositAddressstring
tronDepositAddressstring

Changes

  • aa1767d704faRevision changes
    • info

      the endpoint scheme security internalProjectBearer was added to the API

    • info

      the endpoint scheme security tenantApiKey was added to the API

    • info

      the header request parameter x-api-key became optional

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • a6fd693c3d5fRevision changes
    • info

      added the non-success response with the status