Create Virtual Account

curl --request POST \
  --url https://mapi.zbx.boomfi.xyz/v1/accounts/virtual \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "chain_id": 123,
  "chains": [
    {
      "chain_id": 123,
      "currencies": [
        "<string>"
      ]
    }
  ]
}
'

import requests

url = "https://mapi.zbx.boomfi.xyz/v1/accounts/virtual"

payload = {
    "chain_id": 123,
    "chains": [
        {
            "chain_id": 123,
            "currencies": ["<string>"]
        }
    ]
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({chain_id: 123, chains: [{chain_id: 123, currencies: ['<string>']}]})
};

fetch('https://mapi.zbx.boomfi.xyz/v1/accounts/virtual', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mapi.zbx.boomfi.xyz/v1/accounts/virtual",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'chain_id' => 123,
    'chains' => [
        [
                'chain_id' => 123,
                'currencies' => [
                                '<string>'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://mapi.zbx.boomfi.xyz/v1/accounts/virtual"

	payload := strings.NewReader("{\n  \"chain_id\": 123,\n  \"chains\": [\n    {\n      \"chain_id\": 123,\n      \"currencies\": [\n        \"<string>\"\n      ]\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://mapi.zbx.boomfi.xyz/v1/accounts/virtual")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chain_id\": 123,\n  \"chains\": [\n    {\n      \"chain_id\": 123,\n      \"currencies\": [\n        \"<string>\"\n      ]\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mapi.zbx.boomfi.xyz/v1/accounts/virtual")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chain_id\": 123,\n  \"chains\": [\n    {\n      \"chain_id\": 123,\n      \"currencies\": [\n        \"<string>\"\n      ]\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "account_number": [
      "<string>"
    ],
    "address": "<string>",
    "chain": {
      "id": 123,
      "name": "<string>",
      "native_currency_symbol": "<string>"
    },
    "chain_id": 123,
    "created_at": "<string>",
    "created_by": "<string>",
    "currencies": [
      "<string>"
    ],
    "deleted_at": "<string>",
    "deposit_splits": [
      {
        "account_id": 123,
        "account_ref": "<string>",
        "address": "<string>",
        "pct": "<string>"
      }
    ],
    "enabled": true,
    "id": 123,
    "name": "<string>",
    "org_id": "<string>",
    "parent": "<unknown>",
    "parent_id": 123,
    "payin_fee_pct": 123,
    "payout_fee_pct": 123,
    "properties": {},
    "reference": "<string>",
    "sort_code": [
      "<string>"
    ],
    "sub_accounts": "<array>",
    "updated_at": "<string>"
  },
  "error": true,
  "message": "<string>"
}

{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "orders",
        "reason": "InsufficientQuantity"
      }
    ],
    "message": "Insufficient quantity"
  }
}

{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "orders",
        "reason": "InsufficientQuantity"
      }
    ],
    "message": "Insufficient quantity"
  }
}

{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "orders",
        "reason": "InsufficientQuantity"
      }
    ],
    "message": "Insufficient quantity"
  }
}

POST

accounts

virtual

Create Virtual Account

curl --request POST \
  --url https://mapi.zbx.boomfi.xyz/v1/accounts/virtual \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "chain_id": 123,
  "chains": [
    {
      "chain_id": 123,
      "currencies": [
        "<string>"
      ]
    }
  ]
}
'

import requests

url = "https://mapi.zbx.boomfi.xyz/v1/accounts/virtual"

payload = {
    "chain_id": 123,
    "chains": [
        {
            "chain_id": 123,
            "currencies": ["<string>"]
        }
    ]
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({chain_id: 123, chains: [{chain_id: 123, currencies: ['<string>']}]})
};

fetch('https://mapi.zbx.boomfi.xyz/v1/accounts/virtual', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mapi.zbx.boomfi.xyz/v1/accounts/virtual",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'chain_id' => 123,
    'chains' => [
        [
                'chain_id' => 123,
                'currencies' => [
                                '<string>'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://mapi.zbx.boomfi.xyz/v1/accounts/virtual"

	payload := strings.NewReader("{\n  \"chain_id\": 123,\n  \"chains\": [\n    {\n      \"chain_id\": 123,\n      \"currencies\": [\n        \"<string>\"\n      ]\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://mapi.zbx.boomfi.xyz/v1/accounts/virtual")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chain_id\": 123,\n  \"chains\": [\n    {\n      \"chain_id\": 123,\n      \"currencies\": [\n        \"<string>\"\n      ]\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mapi.zbx.boomfi.xyz/v1/accounts/virtual")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chain_id\": 123,\n  \"chains\": [\n    {\n      \"chain_id\": 123,\n      \"currencies\": [\n        \"<string>\"\n      ]\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "account_number": [
      "<string>"
    ],
    "address": "<string>",
    "chain": {
      "id": 123,
      "name": "<string>",
      "native_currency_symbol": "<string>"
    },
    "chain_id": 123,
    "created_at": "<string>",
    "created_by": "<string>",
    "currencies": [
      "<string>"
    ],
    "deleted_at": "<string>",
    "deposit_splits": [
      {
        "account_id": 123,
        "account_ref": "<string>",
        "address": "<string>",
        "pct": "<string>"
      }
    ],
    "enabled": true,
    "id": 123,
    "name": "<string>",
    "org_id": "<string>",
    "parent": "<unknown>",
    "parent_id": 123,
    "payin_fee_pct": 123,
    "payout_fee_pct": 123,
    "properties": {},
    "reference": "<string>",
    "sort_code": [
      "<string>"
    ],
    "sub_accounts": "<array>",
    "updated_at": "<string>"
  },
  "error": true,
  "message": "<string>"
}

{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "orders",
        "reason": "InsufficientQuantity"
      }
    ],
    "message": "Insufficient quantity"
  }
}

{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "orders",
        "reason": "InsufficientQuantity"
      }
    ],
    "message": "Insufficient quantity"
  }
}

{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "orders",
        "reason": "InsufficientQuantity"
      }
    ],
    "message": "Insufficient quantity"
  }
}

Authorizations

X-API-KEY

string

header

required

Body

application/json

Create virtual account request

chain_id

integer

Blockchain chain ID.

chains

object[]

Per-chain configuration for this virtual account.

Show child attributes

Response

data

object

Response payload when the request succeeded.

Show child attributes

error

boolean

True when the request failed.

message

string

Human-readable status or error message.

Basics

Paylinks

Plans

Subscriptions

Customers

Invoices

Payments

Events

Organisation

Secrets

Accounts

Bank Address Book

Virtual Accounts

Partners

Partner Automations

Partner Balance Monitoring

Instruments

Quotes

Orders

Trades

Create Virtual Account

Authorizations

Body

Response