curl --request GET \
--url https://api.range.org/v2/accounts/transfers \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.range.org/v2/accounts/transfers"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.range.org/v2/accounts/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.range.org/v2/accounts/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 => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.range.org/v2/accounts/transfers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.range.org/v2/accounts/transfers")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.range.org/v2/accounts/transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"account_id": "acc_abc123",
"kind": "TRADE",
"status": "CONFIRMED",
"raw": {},
"transaction_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"provider_transaction_id": "0x9a3f...",
"account": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Treasury wallet",
"type": "eoa",
"groups": [
{
"id": "uuid-1",
"name": "Finance"
}
],
"network": "solana",
"address": "BJE5MMbqXjVwjAF7oxwPYXnTXDyspzZyt4vwenNw5ruG",
"details": {}
},
"provider": "hyperliquid",
"timestamp": "2026-01-15T10:00:00.000Z",
"hash": "0xabc...",
"network": "networks/ethereum-mainnet",
"block_number": "21000000",
"direction": "in",
"usd_amount": "250.50",
"transfers": [
{
"direction": "IN",
"asset": "USDC",
"amount": "100.50",
"usd_amount": "9.831",
"source_address": "0xabc...",
"destination_address": "0xdef...",
"source_label": "Coinbase",
"source_malicious": true,
"source_icon_urls": [
"https://icons.range.org/icons/coinbase.webp"
],
"destination_label": "Treasury",
"destination_malicious": false,
"destination_icon_urls": [
"https://icons.range.org/icons/entity.webp"
]
}
],
"trade": {
"side": "BUY",
"base_asset": "BTC",
"base_amount": "0.01",
"quote_asset": "USDC",
"quote_amount": "500.0",
"price": "50000.0",
"fee": "0.45",
"fee_asset": "USDC",
"realized_pnl": "25.11",
"liquidation": false
},
"fee": {
"amount": "5000",
"denom": "uatom"
},
"category": "Payroll",
"note": "Wire from payroll run"
}
],
"meta": {
"next_cursor": "eyJpZCI6IjkxeFFlV3Z...",
"previous_cursor": "eyJpZCI6IjkxeFFlV3Z...",
"first_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
"last_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
"total_count": 100,
"page_number": 1
}
}List transactions across all accounts in the workspace
Fans out across connection-linked and connectionless accounts in the caller workspace and returns the merged list of transactions, sorted newest-first, capped at size (default 5). Pagination is opaque token (cursor) based — pass meta.next_cursor back as ?cursor to fetch the next page; null next_cursor means no more results. Accounts whose provider does not support transactions, or that fail to fetch, are skipped. Time filters are a half-open UTC Period [start_time, end_time): timestamp >= start_time and timestamp < end_time. A date-only YYYY-MM-DD is that UTC calendar day (start_time is that midnight; end_time is the next UTC midnight). An ISO value with a time is an instant and is not expanded — 2026-08-17T00:00:00Z is midnight, not the whole day. Naive ISO without an offset is interpreted as UTC. When changing the date range, omit cursor; the cursor only encodes .
curl --request GET \
--url https://api.range.org/v2/accounts/transfers \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.range.org/v2/accounts/transfers"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.range.org/v2/accounts/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.range.org/v2/accounts/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 => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.range.org/v2/accounts/transfers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.range.org/v2/accounts/transfers")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.range.org/v2/accounts/transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"account_id": "acc_abc123",
"kind": "TRADE",
"status": "CONFIRMED",
"raw": {},
"transaction_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"provider_transaction_id": "0x9a3f...",
"account": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Treasury wallet",
"type": "eoa",
"groups": [
{
"id": "uuid-1",
"name": "Finance"
}
],
"network": "solana",
"address": "BJE5MMbqXjVwjAF7oxwPYXnTXDyspzZyt4vwenNw5ruG",
"details": {}
},
"provider": "hyperliquid",
"timestamp": "2026-01-15T10:00:00.000Z",
"hash": "0xabc...",
"network": "networks/ethereum-mainnet",
"block_number": "21000000",
"direction": "in",
"usd_amount": "250.50",
"transfers": [
{
"direction": "IN",
"asset": "USDC",
"amount": "100.50",
"usd_amount": "9.831",
"source_address": "0xabc...",
"destination_address": "0xdef...",
"source_label": "Coinbase",
"source_malicious": true,
"source_icon_urls": [
"https://icons.range.org/icons/coinbase.webp"
],
"destination_label": "Treasury",
"destination_malicious": false,
"destination_icon_urls": [
"https://icons.range.org/icons/entity.webp"
]
}
],
"trade": {
"side": "BUY",
"base_asset": "BTC",
"base_amount": "0.01",
"quote_asset": "USDC",
"quote_amount": "500.0",
"price": "50000.0",
"fee": "0.45",
"fee_asset": "USDC",
"realized_pnl": "25.11",
"liquidation": false
},
"fee": {
"amount": "5000",
"denom": "uatom"
},
"category": "Payroll",
"note": "Wire from payroll run"
}
],
"meta": {
"next_cursor": "eyJpZCI6IjkxeFFlV3Z...",
"previous_cursor": "eyJpZCI6IjkxeFFlV3Z...",
"first_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
"last_page_cursor": "eyJpZCI6IjkxeFFlV3Z...",
"total_count": 100,
"page_number": 1
}
}Authorizations
Authorization method required to allow user to access the api endpoints.
Query Parameters
Start of a half-open UTC Period. Date-only YYYY-MM-DD is that UTC midnight. ISO with a time is an instant (naive ISO is UTC).
"2026-08-17"
Exclusive end of a half-open UTC Period. Date-only YYYY-MM-DD is the next UTC midnight. ISO with a time is an instant (naive ISO is UTC).
"2026-08-17"
Opaque cursor returned in meta.next_cursor of a previous response.
"eyJ0aW1lc3RhbXAiOiIyMDI0LTAxLTAyVDAwOjAwOjAwLjAwMFoiLCJpZCI6IjkxIn0="
Maximum number of transactions to return after merging and sorting newest-first across all connections.
1 <= x <= 1005
Comma-separated asset symbols to filter by. A transaction is kept when its displayed asset matches one of these symbols (case-insensitive) — for a trade that is the base asset, otherwise the first transfer leg. Applied to the merged result.
"USDC,ETH"
Comma-separated status aliases (lowercase): 'success' (CONFIRMED), 'errored' (FAILED), 'pending' (PENDING).
PENDING, CONFIRMED, FAILED "success,pending"
Minimum USD amount (decimal). Converted to number.
"100.50"
Maximum USD amount (decimal). Converted to number.
"1000"
Case-insensitive substring search over transaction id, hash, network, asset symbols, and counterparty addresses.
"0xabc"
Limit results to transactions belonging to this account (must be linked to a connection in the workspace).
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Limit results to transactions belonging to any of these accounts (comma-separated UUIDs). Supersedes account_id when both are sent; the singular form stays for links minted before the filter accepted more than one account.
"uuid1,uuid2"
Limit results to accounts belonging to these group IDs (comma-separated UUIDs).
"uuid1,uuid2"
Comma-separated category labels or catalog ids. A transaction is kept when its category matches one of these values (labels are case-insensitive).
"Payroll,Bank Fees"
Comma-separated networks. Restricts on-chain rows (provider is null) to these networks (case-insensitive). Connection rows (provider set) are always returned, including banks/exchanges/custodians with no network.
"eth,solana"
Comma-separated workspace-relative directions: in (counterparty not owned, value received), out (value sent to a non-owned counterparty), internal (both sides are saved workspace accounts). Judged against every saved account regardless of group_ids. Rows with no classifiable leg (trades, unparsed transfers) never match.
in, out, internal "in,out"
Was this page helpful?