Nxosnet
Send nxosnet transfer
Send an internal Nxosnet transfer from an account to an NXOSNET
beneficiary. Funds move directly between the two Nxosnet accounts as ledger
entries — there is no external rail — so the transfer settles instantly and
the response status is COMPLETED.
The beneficiary must be an NXOSNET type belonging to the source account
(create one via POST /v1/beneficiaries/nxosnet), and the target
organization must have Nxosnet transfers enabled.
POST
/
v1
/
transactions
/
nxosnet-transfers
cURL
curl --request POST \
--url https://api.nxos.io/v1/transactions/nxosnet-transfers \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"accountId": "acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"beneficiaryId": "bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"amount": "100.00",
"asset": "USD"
}
'import requests
url = "https://api.nxos.io/v1/transactions/nxosnet-transfers"
payload = {
"accountId": "acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"beneficiaryId": "bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"amount": "100.00",
"asset": "USD"
}
headers = {
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({
accountId: 'acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4',
beneficiaryId: 'bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4',
amount: '100.00',
asset: 'USD'
})
};
fetch('https://api.nxos.io/v1/transactions/nxosnet-transfers', 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://api.nxos.io/v1/transactions/nxosnet-transfers",
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([
'accountId' => 'acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4',
'beneficiaryId' => 'bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4',
'amount' => '100.00',
'asset' => 'USD'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json"
],
]);
$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://api.nxos.io/v1/transactions/nxosnet-transfers"
payload := strings.NewReader("{\n \"accountId\": \"acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"beneficiaryId\": \"bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"amount\": \"100.00\",\n \"asset\": \"USD\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
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.nxos.io/v1/transactions/nxosnet-transfers")
.header("Authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"accountId\": \"acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"beneficiaryId\": \"bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"amount\": \"100.00\",\n \"asset\": \"USD\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nxos.io/v1/transactions/nxosnet-transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"accountId\": \"acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"beneficiaryId\": \"bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"amount\": \"100.00\",\n \"asset\": \"USD\"\n}"
response = http.request(request)
puts response.read_body{
"object": "transaction",
"transactionId": "txn_c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "NXOSNET_TRANSFER",
"status": "COMPLETED",
"accountId": "acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"beneficiaryId": "bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"amount": "100.00",
"asset": "USD",
"targetHandle": "acme",
"createdAt": "2025-03-15T14:32:00.000Z"
}
Headers
Bearer token. Format: Bearer <api_key>
Unique key per logical operation. UUID v4 recommended. Max 255 characters.
Body
application/json
Request body for sending an internal Nxosnet transfer.
Source account to debit.
NXOSNET beneficiary to send to.
Transfer amount in major units (e.g. "100.00").
Asset code (e.g. USD, USDC).
Optional note, shown to the recipient.
Free-form tags (max 20 tags, each up to 100 characters).
Arbitrary metadata (max 50 keys, max 4 KB serialized).
Show child attributes
Show child attributes
Response
The request has succeeded.
A completed internal Nxosnet transfer.
Object type. Always transaction.
Available options:
transaction Unique transaction identifier.
Transaction type. Always NXOSNET_TRANSFER.
Available options:
NXOSNET_TRANSFER Transaction status. Always COMPLETED — internal transfers settle instantly.
Available options:
COMPLETED Source account.
Target beneficiary.
Transfer amount in major units.
Asset code.
The recipient organization's nxosnet handle.
When the transaction was created.
⌘I
cURL
curl --request POST \
--url https://api.nxos.io/v1/transactions/nxosnet-transfers \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"accountId": "acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"beneficiaryId": "bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"amount": "100.00",
"asset": "USD"
}
'import requests
url = "https://api.nxos.io/v1/transactions/nxosnet-transfers"
payload = {
"accountId": "acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"beneficiaryId": "bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"amount": "100.00",
"asset": "USD"
}
headers = {
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({
accountId: 'acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4',
beneficiaryId: 'bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4',
amount: '100.00',
asset: 'USD'
})
};
fetch('https://api.nxos.io/v1/transactions/nxosnet-transfers', 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://api.nxos.io/v1/transactions/nxosnet-transfers",
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([
'accountId' => 'acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4',
'beneficiaryId' => 'bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4',
'amount' => '100.00',
'asset' => 'USD'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json"
],
]);
$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://api.nxos.io/v1/transactions/nxosnet-transfers"
payload := strings.NewReader("{\n \"accountId\": \"acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"beneficiaryId\": \"bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"amount\": \"100.00\",\n \"asset\": \"USD\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
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.nxos.io/v1/transactions/nxosnet-transfers")
.header("Authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"accountId\": \"acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"beneficiaryId\": \"bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"amount\": \"100.00\",\n \"asset\": \"USD\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nxos.io/v1/transactions/nxosnet-transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"accountId\": \"acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"beneficiaryId\": \"bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4\",\n \"amount\": \"100.00\",\n \"asset\": \"USD\"\n}"
response = http.request(request)
puts response.read_body{
"object": "transaction",
"transactionId": "txn_c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "NXOSNET_TRANSFER",
"status": "COMPLETED",
"accountId": "acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"beneficiaryId": "bene_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"amount": "100.00",
"asset": "USD",
"targetHandle": "acme",
"createdAt": "2025-03-15T14:32:00.000Z"
}