Crypto and Fiat Deposits

Request deposit instructions for any supported Crypto or Fiat Assets.

These endpoints are dedicated to retrieving segregated bank accounts and wallet information for deposits. Check the Crypto and Fiat coverage page for more information on the assets and countries available for this feature.

Request deposit instructions for a Crypto Asset

POST https://live.betaapp.com/v1/subaccount/wallet-address/shared

Headers

Name	Type	Description
Authorization*	String	Bearer {access_token}
x-sub-account-id	String	Subaccount-ID
accept*	String	application/json

Request Body

Name	Type	Description
asset*	String	Check crypto asset coverage for more information
network	String	Crypto asset's network

200: OK

400: Bad Request

Request Example:

curl -X 'POST' \
  'https://live.betaapp.com/v1/subaccount/wallet-address/shared' \
  -H 'accept: application/json' \
  -H 'X-sub-account-id: 22376b76...43083b' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InJlaEF1NURPY...ctfx2I4g' \
  -H 'Content-Type: application/json' \
  -d '{
  "asset": "BTC",
  "network": "bitcoin"
}'

Response Example:

{
  {
  "id": "700bea2a-525b-4e88-af32-318088b94643",
  "network": "bitcoin",
  "asset": "BTC",
  "address": "tb1qsm3d89fuuwmn7z699glchxkyk8x235vl4zssvv",
  "address_tag": "",
  "wallet_type": "shared",
  "created_at": "2023-08-05T13:59:01.603085797Z",
  "updated_at": "2023-08-05T13:59:01.603085797Z",
  "deleted_at": null
}

Beta will notify your backend with callbacks as soon as new incoming deposits are confirmed.

Request deposit instructions for a Fiat Asset

POST https://live.betaapp.com/v1/subaccount/bank-account/shared

Headers

Name	Type	Description
Authorization*	String	Bearer {access_token}
x-sub-account-id	String	Subaccount-ID
accept*	String	application/json

Request Body

Name	Type	Description
asset*	String	Check fiat asset coverage for more information

200: OK

400: Bad Request

Request Example:

curl -X 'POST' \
  'https://live.betaapp.com/v1/subaccount/bank-account/shared' \
  -H 'accept: application/json' \
  -H 'X-sub-account-id: 22376b76...43083b' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InJlaEF1NURPY...ctfx2I4g' \
  -H 'Content-Type: application/json' \
  -d '{
  "asset": "MXN",
}'

Response Example:

{
  "id": "870befg4-595c-9z72-jf52-3180995b4643",
  "country": "mexico",
  "asset": "MXN",
  "account": "014027...20",
  "bank_type": "shared",
  "created_at": "2023-08-22T13:59:01.603085797Z",
  "updated_at": "2023-08-22T13:59:01.603085797Z",
  "deleted_at": null
}