curl --request GET \
--url https://api.range.org/v2/treasury/forecast \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.range.org/v2/treasury/forecast"
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/treasury/forecast', 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/treasury/forecast",
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/treasury/forecast"
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/treasury/forecast")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.range.org/v2/treasury/forecast")
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{
"starting_cash_usd": 724819.43,
"avg_monthly_inflow_usd": 18000,
"avg_monthly_outflow_usd": 47200,
"net_monthly_rate_usd": -29200,
"expenses_by_category": [
{
"category": "Payroll",
"avg_monthly_usd": 42000
}
],
"revenue_by_category": [
{
"category": "Payroll",
"avg_monthly_usd": 42000
}
],
"projection": [
{
"month": "2026-06",
"projected_balance_usd": 695619.43
}
],
"data_availability": {
"balances": "available",
"flows": "available",
"historical_balances": "available",
"unpriced_asset_count": 0,
"notes": []
},
"coverage_months": 24.8
}Get treasury cash forecast
Projects future cash position from historical transfer rates (gross — a movement between two of your own accounts counts on both sides). expenses_by_category / revenue_by_category are deferred (always empty). See data_availability for missing provider/sync data.
curl --request GET \
--url https://api.range.org/v2/treasury/forecast \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.range.org/v2/treasury/forecast"
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/treasury/forecast', 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/treasury/forecast",
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/treasury/forecast"
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/treasury/forecast")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.range.org/v2/treasury/forecast")
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{
"starting_cash_usd": 724819.43,
"avg_monthly_inflow_usd": 18000,
"avg_monthly_outflow_usd": 47200,
"net_monthly_rate_usd": -29200,
"expenses_by_category": [
{
"category": "Payroll",
"avg_monthly_usd": 42000
}
],
"revenue_by_category": [
{
"category": "Payroll",
"avg_monthly_usd": 42000
}
],
"projection": [
{
"month": "2026-06",
"projected_balance_usd": 695619.43
}
],
"data_availability": {
"balances": "available",
"flows": "available",
"historical_balances": "available",
"unpriced_asset_count": 0,
"notes": []
},
"coverage_months": 24.8
}Authorizations
Authorization method required to allow user to access the api endpoints.
Query Parameters
Filter accounts by group name (exact match, case-sensitive).
"Treasury"
eoa, multisig, contract, custodian, exchange, bank, defi "bank"
utila, kraken, binance, okx, bybit, bitget, gate, kucoin, plaid, squads, altitude, coinbase, realms, wise, safe, hyperliquid, cubist, privy, dfns, anchorage, revolut_business, turnkey, fordefi, coins_ph, fireblocks, pave_bank, copper "utila"
Filter by account network/chain.
"ethereum"
Filter balances and transfer legs by asset symbol.
"USDC"
How many months to project forward.
1 <= x <= 36How many months of history to average for rates.
1 <= x <= 12Response
724819.43
18000
47200
-29200
Deferred this sprint (RNG-4135) — always []. Categorized spend returns later.
Show child attributes
Show child attributes
Deferred this sprint (RNG-4135) — always []. Categorized revenue returns later.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
24.8
Was this page helpful?