Submit Cryptocurrency Transfer

curl --request POST \
  --url https://api.prod.bastion.com/v2/crypto/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "account_id": "<string>",
  "currency_symbol": "<string>",
  "amount": "<string>",
  "account_destination": {
    "account_id": "<string>"
  },
  "destination_address": "<string>",
  "destination_chain": "ETHEREUM_MAINNET",
  "priority": "PRIORITY_NORMAL",
  "validate_only": true,
  "device_signals": {
    "ip_address": "<string>",
    "device_id": "<string>"
  }
}
'

import requests

url = "https://api.prod.bastion.com/v2/crypto/transfers"

payload = {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "account_id": "<string>",
    "currency_symbol": "<string>",
    "amount": "<string>",
    "account_destination": { "account_id": "<string>" },
    "destination_address": "<string>",
    "destination_chain": "ETHEREUM_MAINNET",
    "priority": "PRIORITY_NORMAL",
    "validate_only": True,
    "device_signals": {
        "ip_address": "<string>",
        "device_id": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    account_id: '<string>',
    currency_symbol: '<string>',
    amount: '<string>',
    account_destination: {account_id: '<string>'},
    destination_address: '<string>',
    destination_chain: 'ETHEREUM_MAINNET',
    priority: 'PRIORITY_NORMAL',
    validate_only: true,
    device_signals: {ip_address: '<string>', device_id: '<string>'}
  })
};

fetch('https://api.prod.bastion.com/v2/crypto/transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    account_id: '<string>',
    currency_symbol: '<string>',
    amount: '<string>',
    account_destination: {account_id: '<string>'},
    destination_address: '<string>',
    destination_chain: 'ETHEREUM_MAINNET',
    priority: 'PRIORITY_NORMAL',
    validate_only: true,
    device_signals: {ip_address: '<string>', device_id: '<string>'}
  })
};

fetch('https://api.prod.bastion.com/v2/crypto/transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://api.prod.bastion.com/v2/crypto/transfers"

	payload := strings.NewReader("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_id\": \"<string>\",\n  \"currency_symbol\": \"<string>\",\n  \"amount\": \"<string>\",\n  \"account_destination\": {\n    \"account_id\": \"<string>\"\n  },\n  \"destination_address\": \"<string>\",\n  \"destination_chain\": \"ETHEREUM_MAINNET\",\n  \"priority\": \"PRIORITY_NORMAL\",\n  \"validate_only\": true,\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.prod.bastion.com/v2/crypto/transfers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_id\": \"<string>\",\n  \"currency_symbol\": \"<string>\",\n  \"amount\": \"<string>\",\n  \"account_destination\": {\n    \"account_id\": \"<string>\"\n  },\n  \"destination_address\": \"<string>\",\n  \"destination_chain\": \"ETHEREUM_MAINNET\",\n  \"priority\": \"PRIORITY_NORMAL\",\n  \"validate_only\": true,\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}")
  .asString();

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_id\": \"<string>\",\n  \"currency_symbol\": \"<string>\",\n  \"amount\": \"<string>\",\n  \"account_destination\": {\n    \"account_id\": \"<string>\"\n  },\n  \"destination_address\": \"<string>\",\n  \"destination_chain\": \"ETHEREUM_MAINNET\",\n  \"priority\": \"PRIORITY_NORMAL\",\n  \"validate_only\": true,\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}")
val request = Request.Builder()
  .url("https://api.prod.bastion.com/v2/crypto/transfers")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

import Foundation

let parameters = [
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "account_id": "<string>",
  "currency_symbol": "<string>",
  "amount": "<string>",
  "account_destination": ["account_id": "<string>"],
  "destination_address": "<string>",
  "destination_chain": "ETHEREUM_MAINNET",
  "priority": "PRIORITY_NORMAL",
  "validate_only": true,
  "device_signals": [
    "ip_address": "<string>",
    "device_id": "<string>"
  ]
] as [String : Any?]

let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])

let url = URL(string: "https://api.prod.bastion.com/v2/crypto/transfers")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
request.httpBody = postData

let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))

using RestSharp;


var options = new RestClientOptions("https://api.prod.bastion.com/v2/crypto/transfers");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_id\": \"<string>\",\n  \"currency_symbol\": \"<string>\",\n  \"amount\": \"<string>\",\n  \"account_destination\": {\n    \"account_id\": \"<string>\"\n  },\n  \"destination_address\": \"<string>\",\n  \"destination_chain\": \"ETHEREUM_MAINNET\",\n  \"priority\": \"PRIORITY_NORMAL\",\n  \"validate_only\": true,\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

require 'uri'
require 'net/http'

url = URI("https://api.prod.bastion.com/v2/crypto/transfers")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_id\": \"<string>\",\n  \"currency_symbol\": \"<string>\",\n  \"amount\": \"<string>\",\n  \"account_destination\": {\n    \"account_id\": \"<string>\"\n  },\n  \"destination_address\": \"<string>\",\n  \"destination_chain\": \"ETHEREUM_MAINNET\",\n  \"priority\": \"PRIORITY_NORMAL\",\n  \"validate_only\": true,\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}"

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

{
  "id": "<string>",
  "request_id": "<string>"
}

POST

crypto

transfers

Submit Cryptocurrency Transfer

curl --request POST \
  --url https://api.prod.bastion.com/v2/crypto/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "account_id": "<string>",
  "currency_symbol": "<string>",
  "amount": "<string>",
  "account_destination": {
    "account_id": "<string>"
  },
  "destination_address": "<string>",
  "destination_chain": "ETHEREUM_MAINNET",
  "priority": "PRIORITY_NORMAL",
  "validate_only": true,
  "device_signals": {
    "ip_address": "<string>",
    "device_id": "<string>"
  }
}
'

import requests

url = "https://api.prod.bastion.com/v2/crypto/transfers"

payload = {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "account_id": "<string>",
    "currency_symbol": "<string>",
    "amount": "<string>",
    "account_destination": { "account_id": "<string>" },
    "destination_address": "<string>",
    "destination_chain": "ETHEREUM_MAINNET",
    "priority": "PRIORITY_NORMAL",
    "validate_only": True,
    "device_signals": {
        "ip_address": "<string>",
        "device_id": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    account_id: '<string>',
    currency_symbol: '<string>',
    amount: '<string>',
    account_destination: {account_id: '<string>'},
    destination_address: '<string>',
    destination_chain: 'ETHEREUM_MAINNET',
    priority: 'PRIORITY_NORMAL',
    validate_only: true,
    device_signals: {ip_address: '<string>', device_id: '<string>'}
  })
};

fetch('https://api.prod.bastion.com/v2/crypto/transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    account_id: '<string>',
    currency_symbol: '<string>',
    amount: '<string>',
    account_destination: {account_id: '<string>'},
    destination_address: '<string>',
    destination_chain: 'ETHEREUM_MAINNET',
    priority: 'PRIORITY_NORMAL',
    validate_only: true,
    device_signals: {ip_address: '<string>', device_id: '<string>'}
  })
};

fetch('https://api.prod.bastion.com/v2/crypto/transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://api.prod.bastion.com/v2/crypto/transfers"

	payload := strings.NewReader("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_id\": \"<string>\",\n  \"currency_symbol\": \"<string>\",\n  \"amount\": \"<string>\",\n  \"account_destination\": {\n    \"account_id\": \"<string>\"\n  },\n  \"destination_address\": \"<string>\",\n  \"destination_chain\": \"ETHEREUM_MAINNET\",\n  \"priority\": \"PRIORITY_NORMAL\",\n  \"validate_only\": true,\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.prod.bastion.com/v2/crypto/transfers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_id\": \"<string>\",\n  \"currency_symbol\": \"<string>\",\n  \"amount\": \"<string>\",\n  \"account_destination\": {\n    \"account_id\": \"<string>\"\n  },\n  \"destination_address\": \"<string>\",\n  \"destination_chain\": \"ETHEREUM_MAINNET\",\n  \"priority\": \"PRIORITY_NORMAL\",\n  \"validate_only\": true,\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}")
  .asString();

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_id\": \"<string>\",\n  \"currency_symbol\": \"<string>\",\n  \"amount\": \"<string>\",\n  \"account_destination\": {\n    \"account_id\": \"<string>\"\n  },\n  \"destination_address\": \"<string>\",\n  \"destination_chain\": \"ETHEREUM_MAINNET\",\n  \"priority\": \"PRIORITY_NORMAL\",\n  \"validate_only\": true,\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}")
val request = Request.Builder()
  .url("https://api.prod.bastion.com/v2/crypto/transfers")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

import Foundation

let parameters = [
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "account_id": "<string>",
  "currency_symbol": "<string>",
  "amount": "<string>",
  "account_destination": ["account_id": "<string>"],
  "destination_address": "<string>",
  "destination_chain": "ETHEREUM_MAINNET",
  "priority": "PRIORITY_NORMAL",
  "validate_only": true,
  "device_signals": [
    "ip_address": "<string>",
    "device_id": "<string>"
  ]
] as [String : Any?]

let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])

let url = URL(string: "https://api.prod.bastion.com/v2/crypto/transfers")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
request.httpBody = postData

let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))

using RestSharp;


var options = new RestClientOptions("https://api.prod.bastion.com/v2/crypto/transfers");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_id\": \"<string>\",\n  \"currency_symbol\": \"<string>\",\n  \"amount\": \"<string>\",\n  \"account_destination\": {\n    \"account_id\": \"<string>\"\n  },\n  \"destination_address\": \"<string>\",\n  \"destination_chain\": \"ETHEREUM_MAINNET\",\n  \"priority\": \"PRIORITY_NORMAL\",\n  \"validate_only\": true,\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

require 'uri'
require 'net/http'

url = URI("https://api.prod.bastion.com/v2/crypto/transfers")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"account_id\": \"<string>\",\n  \"currency_symbol\": \"<string>\",\n  \"amount\": \"<string>\",\n  \"account_destination\": {\n    \"account_id\": \"<string>\"\n  },\n  \"destination_address\": \"<string>\",\n  \"destination_chain\": \"ETHEREUM_MAINNET\",\n  \"priority\": \"PRIORITY_NORMAL\",\n  \"validate_only\": true,\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}"

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

{
  "id": "<string>",
  "request_id": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication with an API token

Query Parameters

preflight_checks

enum<string>[]

Checks to run synchronously before the transfer is accepted, trading a little request latency for an immediate error instead of an asynchronous failure. Sent as a repeated query parameter; omitting it preserves existing behavior. A value outside the list below refuses the request.

PreflightCheck names a validation that can run synchronously at submit time.

Available options:

PREFLIGHT_CHECK_UNSPECIFIED,

PREFLIGHT_CHECK_BALANCE

Body

application/json

The transfer to submit. Sent as the request body. Kept as its own message so persisted approval payloads keep decoding.

transfer
transfer

The transfer to submit. Sent as the request body. Kept as its own message so persisted approval payloads keep decoding.

request_id

string<uuid>

required

Request identifier in a UUID format. Serves as an idempotency key.

Pattern: [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}

account_id

string

required

Unique identifier of the account transferring the cryptocurrency

currency_symbol

string

required

Symbol or ticker of the cryptocurrency to send

amount

string

required

Amount to send in the asset currency's default unit (ex: Ether for ETH)

account_destination

account_destination · object

Internal Bastion account destination for P2P transfers

Show child attributes

destination_address

string

deprecated

Deprecated: use address_destination instead.

Address of the recipient to receive the cryptocurrency.

destination_chain

enum<string>

deprecated

Deprecated: use address_destination instead.

Chain identifier for the cryptocurrency transaction.

Available options:

CHAIN_UNSPECIFIED,

ETHEREUM_MAINNET,

POLYGON_MAINNET,

ETHEREUM_TESTNET,

OPTIMISM_SEPOLIA,

BASE_MAINNET,

BASE_SEPOLIA,

OPTIMISM_MAINNET,

POLYGON_AMOY,

SOLANA_MAINNET,

SOLANA_DEVNET

Example:

"ETHEREUM_MAINNET"

priority

enum<string>

deprecated

Optional inclusion priority for the cryptocurrency transfer transaction. Higher priority results in faster confirmation times but higher gas fee spend.

⚠️ Transaction Priority

Setting a higher priority expedites your transaction by increasing the gas price used to submit the transaction.

Please note, however, that high-priority transfers may be delayed if the account has pending lower-priority transactions that must be processed first in sequence.

Available options:

PRIORITY_UNSPECIFIED,

PRIORITY_NORMAL,

PRIORITY_HIGH,

PRIORITY_URGENT

Example:

"PRIORITY_NORMAL"

validate_only

boolean

If true, only validates the request without executing the transfer. When set, all validations are run but no transfer is submitted.

device_signals

DeviceSignals · object | null

DeviceSignals carries client device/network identifiers captured at request time for value-moving, user-initiated endpoints.

Show child attributes

Response

Success

string

request_id

string

Authentication

API Reference

Webhooks

Submit Cryptocurrency Transfer

Authorizations

Query Parameters

Body

Response