Create a deposit account

POSThttps://api.radom.com/deposit/account

Authorization

Send your API key in the Authorization header. Scheme: radomToken.

Request body

namestringrequired

accountDetailsCreateDepositAccountDetailsReqrequired

CryptoCreateCryptoDepositAccountDetailsReqrequired

depositMethodsCryptoDepositMethod[]required

networkNetworkrequired

AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetCardanoDashSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetZcashZcashTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetFiat

tokenstringnullable

isExternalbooleanrequired

customerIdstring<uuid>nullable

treasuryIdstring<uuid>nullable

FiatCreateFiatDepositAccountDetailsReqrequired

currencyCurrencyrequired

AllowedUSDCADGBPEURAEDINRSEKBRLNZDAUDHKDNOKDKKJPYCNYCHFSGDPLNMXNCZKHUFZARSARRUBTRYILSUSDCUSDTEURCBTCTEST0ETHBNBSOLTRXAVAXMATIC

networkNetworkrequired

AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetCardanoDashSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetZcashZcashTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetFiat

tokenstringnullable

Responses

200Deposit account created successfully

idstring<uuid>required

organizationIdstring<uuid>required

namestringrequired

statusDepositAccountStatusrequired

Allowedactivedisabled

accountTypeDepositAccountTyperequired

Allowedcryptofiat

accountDetailsDepositAccountDetailsrequired

CryptoDepositCryptoAccountDetailsrequired

addressstringrequired

depositMethodsCryptoDepositMethod[]required

networkNetworkrequired

AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetCardanoDashSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetZcashZcashTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetFiat

tokenstringnullable

customerIdstring<uuid>nullable

isExternalbooleannullable

treasuryIdstring<uuid>nullable

FiatFiatDepositAccountrequired

bankNamestringnullable

bankAddressstringnullable

accountTypeFiatDepositAccountDetailsrequired

ibanIbanDepositAccountDetailsrequired

ibanstringrequired

bicstringrequired

accountHolderNamestringnullable

sourceCurrencystringnullable

sourcePaymentRailsstring[]nullable

destinationCurrencystringnullable

destinationPaymentRailstringnullable

usUsDepositAccountDetailsrequired

accountNumberstringrequired

routingNumberstringrequired

bankBeneficiaryNamestringnullable

bankBeneficiaryAddressstringnullable

sourceCurrencystringnullable

sourcePaymentRailsstring[]nullable

destinationCurrencystringnullable

destinationPaymentRailstringnullable

speiSpeiDepositAccountDetailsrequired

clabestringrequired

accountHolderNamestringnullable

sourceCurrencystringnullable

sourcePaymentRailsstring[]nullable

destinationCurrencystringnullable

destinationPaymentRailstringnullable

pixPixDepositAccountDetailsrequired

brCodestringrequired

accountHolderNamestringnullable

sourceCurrencystringnullable

sourcePaymentRailsstring[]nullable

destinationCurrencystringnullable

destinationPaymentRailstringnullable

isMasterbooleanrequired

createdAtstring<date-time>required

customerRelatedCustomernullable

idstring<uuid>required

namestringrequired

emailstringrequired

400Bad Request

errorstringrequired

401Unauthorized

errorstringrequired

500Internal server error

errorstringrequired

503Virtual account creation is temporarily unavailable

errorstringrequired

RequestCrypto deposit account

{
  "name": "Primary crypto deposits",
  "accountDetails": {
    "Crypto": {
      "depositMethods": [
        {
          "network": "Ethereum",
          "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        }
      ],
      "isExternal": false
    }
  }
}

Fiat deposit account

{
  "name": "Primary USD deposits",
  "accountDetails": {
    "Fiat": {
      "currency": "USD",
      "network": "Fiat",
      "token": null
    }
  }
}

Shell

curl -X POST https://api.radom.com/deposit/account \
  -H 'Authorization: <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Primary crypto deposits",
  "accountDetails": {
    "Crypto": {
      "depositMethods": [
        {
          "network": "Ethereum",
          "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        }
      ],
      "isExternal": false
    }
  }
}'

Try it

Sends a real POST to https://api.radom.com/deposit/account

This operation moves funds. There is no test environment for it here — the request goes to the production API and its effects are real.

API key

Held in this page only, and discarded when you navigate away. It is not stored and is sent to api.radom.com and nowhere else.

Request body{ "name": "Primary crypto deposits", "accountDetails": { "Crypto": { "depositMethods": [ { "network": "Ethereum", "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" } ], "isExternal": false } } }