Get Transaction Transfers

curl --request GET \
  --url https://api-gateway.sonarx.com/api/v1/customer/{chain}/transaction-transfers \
  --header 'apikey: <api-key>'

import requests

url = "https://api-gateway.sonarx.com/api/v1/customer/{chain}/transaction-transfers"

headers = {"apikey": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {apikey: '<api-key>'}};

fetch('https://api-gateway.sonarx.com/api/v1/customer/{chain}/transaction-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-gateway.sonarx.com/api/v1/customer/{chain}/transaction-transfers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "apikey: <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"
	"net/http"
	"io"
)

func main() {

	url := "https://api-gateway.sonarx.com/api/v1/customer/{chain}/transaction-transfers"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("apikey", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-gateway.sonarx.com/api/v1/customer/{chain}/transaction-transfers")

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

request = Net::HTTP::Get.new(url)
request["apikey"] = '<api-key>'

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

{
  "query": {
    "chain": "arbitrum",
    "block_number": 23463206,
    "transaction_hash": "0x62b16b03e641e3a14d8aa6e6c1f740eb530ff9a34306cf5ece3f7c25f7083524"
  },
  "offset": 0,
  "limit": 100,
  "count": 2,
  "result": [
    {
      "block_number": 23463206,
      "datetime": "2022-09-07T23:14:19",
      "wallet_selection": "0xc39e5f40ba9ef2294663c0a5ba0cc8776ac90efe",
      "protocol": "arbitrum",
      "asset": "Wrapped Ether",
      "contract_address": "0x82af49447d8a07e3bd95bd0d56f35241523fbab1",
      "transaction_hash": "0x62b16b03e641e3a14d8aa6e6c1f740eb530ff9a34306cf5ece3f7c25f7083524",
      "sending_address": "0x1b02da8cb0d097eb8d57a175b88c7d8b47997506",
      "receiving_address": "0xe8ee01ae5959d3231506fcdef2d5f3e85987a39c",
      "quantity_transferred": 0.000001347077520779,
      "transaction_fee": 0.0000739179,
      "transaction_fee_asset": "ETH"
    },
    {
      "block_number": 23463206,
      "datetime": "2022-09-07T23:14:19",
      "wallet_selection": "0xc39e5f40ba9ef2294663c0a5ba0cc8776ac90efe",
      "protocol": "arbitrum",
      "asset": "ETH",
      "contract_address": null,
      "transaction_hash": "0x62b16b03e641e3a14d8aa6e6c1f740eb530ff9a34306cf5ece3f7c25f7083524",
      "sending_address": "0x1b02da8cb0d097eb8d57a175b88c7d8b47997506",
      "receiving_address": "0x82af49447d8a07e3bd95bd0d56f35241523fbab1",
      "quantity_transferred": 0.000001347077520779,
      "transaction_fee": 0.0000739179,
      "transaction_fee_asset": "ETH"
    }
  ]
}

{
  "detail": "API key is not enabled for this endpoint"
}

{
  "detail": "API key is not enabled for this endpoint"
}

{
  "detail": "API key is not enabled for this endpoint"
}

{
  "detail": "API key is not enabled for this endpoint"
}

GET

api

customer

{chain}

transaction-transfers

Get Transaction Transfers

curl --request GET \
  --url https://api-gateway.sonarx.com/api/v1/customer/{chain}/transaction-transfers \
  --header 'apikey: <api-key>'

import requests

url = "https://api-gateway.sonarx.com/api/v1/customer/{chain}/transaction-transfers"

headers = {"apikey": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {apikey: '<api-key>'}};

fetch('https://api-gateway.sonarx.com/api/v1/customer/{chain}/transaction-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-gateway.sonarx.com/api/v1/customer/{chain}/transaction-transfers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "apikey: <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"
	"net/http"
	"io"
)

func main() {

	url := "https://api-gateway.sonarx.com/api/v1/customer/{chain}/transaction-transfers"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("apikey", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-gateway.sonarx.com/api/v1/customer/{chain}/transaction-transfers")

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

request = Net::HTTP::Get.new(url)
request["apikey"] = '<api-key>'

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

{
  "query": {
    "chain": "arbitrum",
    "block_number": 23463206,
    "transaction_hash": "0x62b16b03e641e3a14d8aa6e6c1f740eb530ff9a34306cf5ece3f7c25f7083524"
  },
  "offset": 0,
  "limit": 100,
  "count": 2,
  "result": [
    {
      "block_number": 23463206,
      "datetime": "2022-09-07T23:14:19",
      "wallet_selection": "0xc39e5f40ba9ef2294663c0a5ba0cc8776ac90efe",
      "protocol": "arbitrum",
      "asset": "Wrapped Ether",
      "contract_address": "0x82af49447d8a07e3bd95bd0d56f35241523fbab1",
      "transaction_hash": "0x62b16b03e641e3a14d8aa6e6c1f740eb530ff9a34306cf5ece3f7c25f7083524",
      "sending_address": "0x1b02da8cb0d097eb8d57a175b88c7d8b47997506",
      "receiving_address": "0xe8ee01ae5959d3231506fcdef2d5f3e85987a39c",
      "quantity_transferred": 0.000001347077520779,
      "transaction_fee": 0.0000739179,
      "transaction_fee_asset": "ETH"
    },
    {
      "block_number": 23463206,
      "datetime": "2022-09-07T23:14:19",
      "wallet_selection": "0xc39e5f40ba9ef2294663c0a5ba0cc8776ac90efe",
      "protocol": "arbitrum",
      "asset": "ETH",
      "contract_address": null,
      "transaction_hash": "0x62b16b03e641e3a14d8aa6e6c1f740eb530ff9a34306cf5ece3f7c25f7083524",
      "sending_address": "0x1b02da8cb0d097eb8d57a175b88c7d8b47997506",
      "receiving_address": "0x82af49447d8a07e3bd95bd0d56f35241523fbab1",
      "quantity_transferred": 0.000001347077520779,
      "transaction_fee": 0.0000739179,
      "transaction_fee_asset": "ETH"
    }
  ]
}

{
  "detail": "API key is not enabled for this endpoint"
}

{
  "detail": "API key is not enabled for this endpoint"
}

{
  "detail": "API key is not enabled for this endpoint"
}

{
  "detail": "API key is not enabled for this endpoint"
}

Required Parameters: Both transaction_hash and block_number must be provided — the block number pins the transaction so its transfers can be located efficiently.

Returns every transfer that happened inside one transaction:

Token transfers — ERC-20 and other priced token movements, with the token’s asset symbol and contract_address.
Native internal transfers — value moved by internal calls in the chain’s native asset (ETH, POL, BNB, AVAX, xDAI). These rows have contract_address: null.

Each row also carries the transaction context: wallet_selection (the transaction sender), transaction_fee, and transaction_fee_asset. Supported chains: ethereum, polygon, base, arbitrum, optimism, binance, avalanche, gnosis. Gnosis has no internal-transfer feed, so it returns token transfers only.

Example Requests

Get all transfers for a transaction:

curl -s "https://api-gateway.sonarx.com/api/v1/customer/ethereum/transaction-transfers?transaction_hash=0xe6b8fb001206483fdda45b18ffa903b4c99d87e65b16ad9b01ac5e148f65aea6&block_number=2341625" \
  -H "apikey: YOUR_API_KEY" | jq

Another chain — same shape, just change the path segment:

curl -s "https://api-gateway.sonarx.com/api/v1/customer/arbitrum/transaction-transfers?transaction_hash=0x62b16b03e641e3a14d8aa6e6c1f740eb530ff9a34306cf5ece3f7c25f7083524&block_number=23463206" \
  -H "apikey: YOUR_API_KEY" | jq

Paginate a transfer-heavy transaction (results are deterministically ordered, so pages never overlap or drift):

curl -s "https://api-gateway.sonarx.com/api/v1/customer/gnosis/transaction-transfers?transaction_hash=0x66d0cb2cad2950f06aea544a5b9f1c4048284c148c319a96cba6d8f09cc37d5c&block_number=28002542&limit=1000&offset=0" \
  -H "apikey: YOUR_API_KEY" | jq

# next page
curl -s "https://api-gateway.sonarx.com/api/v1/customer/gnosis/transaction-transfers?transaction_hash=0x66d0cb2cad2950f06aea544a5b9f1c4048284c148c319a96cba6d8f09cc37d5c&block_number=28002542&limit=1000&offset=1000" \
  -H "apikey: YOUR_API_KEY" | jq

Pagination

limit (1–1000, default 100) and offset (default 0) page through the results; count in the response is the number of rows in the current page — keep advancing offset by limit until count < limit.

Authorizations

apikey

string

header

required

API key for authentication

Path Parameters

chain

enum<string>

required

The blockchain network to query

Available options:

ethereum,

polygon,

base,

arbitrum,

optimism,

binance,

avalanche,

gnosis

Example:

"ethereum"

Query Parameters

transaction_hash

string

required

Transaction hash (0x-prefixed, 64 hex chars)

Maximum string length: 66

Pattern: ^0x[a-fA-F0-9]{64}$

Example:

"0x62b16b03e641e3a14d8aa6e6c1f740eb530ff9a34306cf5ece3f7c25f7083524"

block_number

integer

required

Block number the transaction is in

Required range: x >= 0

Example:

23463206

limit

integer

default:100

Maximum number of results to return (1-1000)

Required range: 1 <= x <= 1000

offset

integer

default:0

Number of results to skip

Required range: x >= 0

Response

Transfers for the transaction

query

object

required

Echo of the filters applied to the request

Show child attributes

offset

integer

required

Number of results skipped

limit

integer

required

Maximum number of results requested

count

integer

required

Number of results returned in this page

result

object[]

required

Show child attributes

⌘I

APIs

Streams & Feeds

Get Transaction Transfers

Example Requests

Authorizations

Path Parameters

Query Parameters

Response

​Example Requests

​Pagination

Authorizations

Path Parameters

Query Parameters

Response

Example Requests

Pagination