Multi-source reconciliation
curl --request POST \
--url https://api.range.org/v2/reconciliation/multi-source \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"start_time": "2026-09-01T00:00:00Z",
"end_time": "2026-09-30T00:00:00Z",
"books_end_time": "2026-09-16T00:00:00Z",
"assets": [
"USDC"
],
"reporting_currency": "USD",
"show_all": false
}
'import requests
url = "https://api.range.org/v2/reconciliation/multi-source"
payload = {
"account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"start_time": "2026-09-01T00:00:00Z",
"end_time": "2026-09-30T00:00:00Z",
"books_end_time": "2026-09-16T00:00:00Z",
"assets": ["USDC"],
"reporting_currency": "USD",
"show_all": False
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
account_id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
start_time: '2026-09-01T00:00:00Z',
end_time: '2026-09-30T00:00:00Z',
books_end_time: '2026-09-16T00:00:00Z',
assets: ['USDC'],
reporting_currency: 'USD',
show_all: false
})
};
fetch('https://api.range.org/v2/reconciliation/multi-source', 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/reconciliation/multi-source",
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([
'account_id' => 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
'start_time' => '2026-09-01T00:00:00Z',
'end_time' => '2026-09-30T00:00:00Z',
'books_end_time' => '2026-09-16T00:00:00Z',
'assets' => [
'USDC'
],
'reporting_currency' => 'USD',
'show_all' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.range.org/v2/reconciliation/multi-source"
payload := strings.NewReader("{\n \"account_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"start_time\": \"2026-09-01T00:00:00Z\",\n \"end_time\": \"2026-09-30T00:00:00Z\",\n \"books_end_time\": \"2026-09-16T00:00:00Z\",\n \"assets\": [\n \"USDC\"\n ],\n \"reporting_currency\": \"USD\",\n \"show_all\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
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.range.org/v2/reconciliation/multi-source")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"start_time\": \"2026-09-01T00:00:00Z\",\n \"end_time\": \"2026-09-30T00:00:00Z\",\n \"books_end_time\": \"2026-09-16T00:00:00Z\",\n \"assets\": [\n \"USDC\"\n ],\n \"reporting_currency\": \"USD\",\n \"show_all\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.range.org/v2/reconciliation/multi-source")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"start_time\": \"2026-09-01T00:00:00Z\",\n \"end_time\": \"2026-09-30T00:00:00Z\",\n \"books_end_time\": \"2026-09-16T00:00:00Z\",\n \"assets\": [\n \"USDC\"\n ],\n \"reporting_currency\": \"USD\",\n \"show_all\": false\n}"
response = http.request(request)
puts response.read_body{
"requested_period": {
"start_time": "2026-07-01T00:00:00.000Z",
"end_time": "2026-08-01T00:00:00.000Z"
},
"reporting_currency": "USD",
"holding": {
"chain_account_id": "<string>",
"custodian_account_id": "<string>",
"ledger_account_id": "<string>"
},
"accounts": [
{
"account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"label": "custodian",
"status": "ok",
"declared_gaps": [
{
"reason": "trade_quote_leg_unattributed",
"asset": "USDC",
"quantity": "500.00",
"transaction_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
],
"effective_period": {
"start_time": "2026-07-01T00:00:00.000Z",
"end_time": "2026-08-01T00:00:00.000Z"
},
"unreconcilable_reason": "network_reconciliation_unsupported"
}
],
"assets": [
{
"asset": {
"network": "ethereum",
"symbol": "USDC",
"token_address": "native"
},
"custody": {
"status": "agreed",
"cause": "missing_on_chain"
},
"books": {
"status": "agreed",
"cause": "missing_on_chain"
},
"status": "agreed",
"cause": "missing_on_chain",
"per_tape": [
{
"tape": "chain",
"status": "ok",
"account_id": "<string>",
"unreconcilable_reason": "network_reconciliation_unsupported",
"opening_quantity": "<string>",
"inflows": "<string>",
"outflows": "<string>",
"fees": "<string>",
"opening_block": "<string>",
"closing_block": "<string>",
"movements_quantity": "<string>",
"computed_closing_quantity": "<string>",
"actual_closing_quantity": "<string>",
"difference": "<string>",
"tie_out_status": "tied",
"declared_gap_reason": "trade_quote_leg_unattributed",
"opening_evidence": {
"obtained_by": "enrolment_walkback",
"custodian_read_at": "2026-10-05T15:00:00.000Z",
"transaction_count": 3,
"evidence": "walked back through 3 transactions",
"statuses": [
"Confirmed"
]
},
"closing_evidence": {
"obtained_by": "enrolment_walkback",
"custodian_read_at": "2026-10-05T15:00:00.000Z",
"transaction_count": 3,
"evidence": "walked back through 3 transactions",
"statuses": [
"Confirmed"
]
}
}
],
"unmatched_movements": [
{
"tape": "chain",
"symbol": "USDC",
"quantity": "25",
"kind": "transfer",
"missing_on": [
"chain"
],
"tx_hash": "<string>",
"source_ref": "<string>"
}
],
"unmatchable_movements": [
{
"tape": "chain",
"symbol": "<string>",
"quantity": "<string>",
"tx_hash": null,
"kind": "transfer",
"reason": "no hash, cannot match",
"source_ref": "<string>"
}
],
"symbol_only": true,
"unverified_by_custodian": true,
"books_custodian_close_quantity": "<string>",
"custodian_unverified": {
"provider": "dfns",
"token_address": "SLNDpmoWTVADgEdndyvWzroNL7zSi1dF9PC3xHGtPwp",
"chain_close": "<string>",
"ledger_close": "<string>"
},
"declared_gap": {
"tape": "custodian",
"reason": "custodian_walkback_negative"
}
}
],
"unmatched_assets": [
"<string>"
]
}Reconciliation
Request multi-source reconciliation
Accept a JSON request for account reconciliation across sources.
POST
/
v2
/
reconciliation
/
multi-source
Multi-source reconciliation
curl --request POST \
--url https://api.range.org/v2/reconciliation/multi-source \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"start_time": "2026-09-01T00:00:00Z",
"end_time": "2026-09-30T00:00:00Z",
"books_end_time": "2026-09-16T00:00:00Z",
"assets": [
"USDC"
],
"reporting_currency": "USD",
"show_all": false
}
'import requests
url = "https://api.range.org/v2/reconciliation/multi-source"
payload = {
"account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"start_time": "2026-09-01T00:00:00Z",
"end_time": "2026-09-30T00:00:00Z",
"books_end_time": "2026-09-16T00:00:00Z",
"assets": ["USDC"],
"reporting_currency": "USD",
"show_all": False
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
account_id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
start_time: '2026-09-01T00:00:00Z',
end_time: '2026-09-30T00:00:00Z',
books_end_time: '2026-09-16T00:00:00Z',
assets: ['USDC'],
reporting_currency: 'USD',
show_all: false
})
};
fetch('https://api.range.org/v2/reconciliation/multi-source', 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/reconciliation/multi-source",
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([
'account_id' => 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
'start_time' => '2026-09-01T00:00:00Z',
'end_time' => '2026-09-30T00:00:00Z',
'books_end_time' => '2026-09-16T00:00:00Z',
'assets' => [
'USDC'
],
'reporting_currency' => 'USD',
'show_all' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.range.org/v2/reconciliation/multi-source"
payload := strings.NewReader("{\n \"account_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"start_time\": \"2026-09-01T00:00:00Z\",\n \"end_time\": \"2026-09-30T00:00:00Z\",\n \"books_end_time\": \"2026-09-16T00:00:00Z\",\n \"assets\": [\n \"USDC\"\n ],\n \"reporting_currency\": \"USD\",\n \"show_all\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
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.range.org/v2/reconciliation/multi-source")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"start_time\": \"2026-09-01T00:00:00Z\",\n \"end_time\": \"2026-09-30T00:00:00Z\",\n \"books_end_time\": \"2026-09-16T00:00:00Z\",\n \"assets\": [\n \"USDC\"\n ],\n \"reporting_currency\": \"USD\",\n \"show_all\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.range.org/v2/reconciliation/multi-source")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"start_time\": \"2026-09-01T00:00:00Z\",\n \"end_time\": \"2026-09-30T00:00:00Z\",\n \"books_end_time\": \"2026-09-16T00:00:00Z\",\n \"assets\": [\n \"USDC\"\n ],\n \"reporting_currency\": \"USD\",\n \"show_all\": false\n}"
response = http.request(request)
puts response.read_body{
"requested_period": {
"start_time": "2026-07-01T00:00:00.000Z",
"end_time": "2026-08-01T00:00:00.000Z"
},
"reporting_currency": "USD",
"holding": {
"chain_account_id": "<string>",
"custodian_account_id": "<string>",
"ledger_account_id": "<string>"
},
"accounts": [
{
"account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"label": "custodian",
"status": "ok",
"declared_gaps": [
{
"reason": "trade_quote_leg_unattributed",
"asset": "USDC",
"quantity": "500.00",
"transaction_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
],
"effective_period": {
"start_time": "2026-07-01T00:00:00.000Z",
"end_time": "2026-08-01T00:00:00.000Z"
},
"unreconcilable_reason": "network_reconciliation_unsupported"
}
],
"assets": [
{
"asset": {
"network": "ethereum",
"symbol": "USDC",
"token_address": "native"
},
"custody": {
"status": "agreed",
"cause": "missing_on_chain"
},
"books": {
"status": "agreed",
"cause": "missing_on_chain"
},
"status": "agreed",
"cause": "missing_on_chain",
"per_tape": [
{
"tape": "chain",
"status": "ok",
"account_id": "<string>",
"unreconcilable_reason": "network_reconciliation_unsupported",
"opening_quantity": "<string>",
"inflows": "<string>",
"outflows": "<string>",
"fees": "<string>",
"opening_block": "<string>",
"closing_block": "<string>",
"movements_quantity": "<string>",
"computed_closing_quantity": "<string>",
"actual_closing_quantity": "<string>",
"difference": "<string>",
"tie_out_status": "tied",
"declared_gap_reason": "trade_quote_leg_unattributed",
"opening_evidence": {
"obtained_by": "enrolment_walkback",
"custodian_read_at": "2026-10-05T15:00:00.000Z",
"transaction_count": 3,
"evidence": "walked back through 3 transactions",
"statuses": [
"Confirmed"
]
},
"closing_evidence": {
"obtained_by": "enrolment_walkback",
"custodian_read_at": "2026-10-05T15:00:00.000Z",
"transaction_count": 3,
"evidence": "walked back through 3 transactions",
"statuses": [
"Confirmed"
]
}
}
],
"unmatched_movements": [
{
"tape": "chain",
"symbol": "USDC",
"quantity": "25",
"kind": "transfer",
"missing_on": [
"chain"
],
"tx_hash": "<string>",
"source_ref": "<string>"
}
],
"unmatchable_movements": [
{
"tape": "chain",
"symbol": "<string>",
"quantity": "<string>",
"tx_hash": null,
"kind": "transfer",
"reason": "no hash, cannot match",
"source_ref": "<string>"
}
],
"symbol_only": true,
"unverified_by_custodian": true,
"books_custodian_close_quantity": "<string>",
"custodian_unverified": {
"provider": "dfns",
"token_address": "SLNDpmoWTVADgEdndyvWzroNL7zSi1dF9PC3xHGtPwp",
"chain_close": "<string>",
"ledger_close": "<string>"
},
"declared_gap": {
"tape": "custodian",
"reason": "custodian_walkback_negative"
}
}
],
"unmatched_assets": [
"<string>"
]
}Authorizations
AuthorizationAuthorization
Authorization method required to allow user to access the api endpoints.
Body
application/json
Custodian wallet account to reconcile.
Example:
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Period start (ISO 8601). Must be before the effective end.
Example:
"2026-09-01T00:00:00Z"
Period end (ISO 8601). Omit for the live period — the server fills and echoes the instant used (now).
Example:
"2026-09-30T00:00:00Z"
Books pair window end (ISO 8601). When it is strictly inside (start_time, end_time), Books is compared through this instant and the custodian close is computed. Omit to compare Books through end_time.
Example:
"2026-09-16T00:00:00Z"
Restrict the comparison to these display symbols (catalogue-normalised). A symbol that is not in the catalogue is rejected. Omit to compare every asset held. At most 50.
Example:
["USDC"]
Display currency. Only 'USD' is supported today.
Example:
"USD"
Bypass the workspace token whitelist on both sides of every line, same meaning as on the roll-forward endpoint.
Response
Show child attributes
Show child attributes
Example:
"USD"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Requested display symbols that matched no line.
Last modified on November 10, 2026
Was this page helpful?