Tax API

curl

# Every reward, transfer, swap and fee in October, priced in USD at receipt
curl -s "https://bryanlabs.net/api/tax/v1/events?address=cosmos18ruzecmqj9pv8ac0gvkgryuc7u004te9xr2mcr&start=2026-10-01&end=2026-10-31&format=json" | jq '.summary'

# The same rows as CSV
curl -s -o events.csv "https://bryanlabs.net/api/tax/v1/events?address=cosmos18ruzecmqj9pv8ac0gvkgryuc7u004te9xr2mcr&start=2026-10-01&end=2026-10-31&format=csv"

# One validator's commission and delegator rewards by month
curl -s "https://bryanlabs.net/api/tax/v1/validator-statement?validator=cosmosvaloper18ruzecmqj9pv8ac0gvkgryuc7u004te9rh7w5s&start=2026-10-01&end=2026-10-31" | jq '.months'

JavaScript (Node 18+ or browser)

const url = new URL("https://bryanlabs.net/api/tax/v1/journal");
url.search = new URLSearchParams({
  address: "cosmos18ruzecmqj9pv8ac0gvkgryuc7u004te9xr2mcr",
  start: "2026-10-01",
  end: "2026-10-31",
  format: "json",
}).toString();

const res = await fetch(url);
if (!res.ok) {
  const problem = await res.json(); // RFC 9457: type, title, status, detail, code, request_id
  throw new Error(`${problem.code}: ${problem.detail} (request ${problem.request_id})`);
}
const journal = await res.json();
console.log(journal.lines.length, "journal lines; coverage:", journal.index_coverage?.complete);

Python 3 (standard library)

import json, time, urllib.parse, urllib.request
from urllib.error import HTTPError

params = urllib.parse.urlencode(
    {"address": "cosmos18ruzecmqj9pv8ac0gvkgryuc7u004te9xr2mcr", "start": "2026-10-01", "end": "2026-10-31", "type": "rewards"}
)
url = f"https://bryanlabs.net/api/tax/v1/events?{params}"

for attempt in range(3):
    try:
        with urllib.request.urlopen(url, timeout=120) as res:
            events = json.load(res)
        break
    except HTTPError as e:
        if e.code == 429:
            time.sleep(int(e.headers.get("Retry-After", "60")))
            continue
        problem = json.load(e)
        raise SystemExit(f"{problem['code']}: {problem['detail']} (request {problem['request_id']})")

print(events["summary"])