Free Public API

API Documentation

Free REST API for cryptocurrency tax data across 199 countries. No authentication required. Updated monthly from official sources.

199

Countries

100/min

Rate Limit

Free

No API Key

Quick Start

1. Get All Countries

curl https://cryptonomadhub-prod-1.onrender.com/regulations

2. Get Single Country

curl https://cryptonomadhub-prod-1.onrender.com/regulations/AE

Endpoints

GET/regulations

Get all countries with their tax rates and regulations.

Query Parameters

Parameter	Type	Description
include_analysis	boolean	Include AI analysis (default: false)
reliable_only	boolean	Only high-quality data (default: false)

Example Request

curl "https://cryptonomadhub-prod-1.onrender.com/regulations?include_analysis=true"

GET/regulations/{country_code}

Get a specific country by ISO 3166-1 alpha-2 code (e.g., "AE", "US", "PT").

Example Request

curl https://cryptonomadhub-prod-1.onrender.com/regulations/AE

Response Schema

{
  "country_code": "AE",
  "country_name": "United Arab Emirates",
  "flag_emoji": "🇦🇪",
  "cgt_short_rate": 0,
  "cgt_long_rate": 0,
  "crypto_short_rate": 0,
  "crypto_long_rate": 0,
  "crypto_legal_status": "legal",
  "holding_period_months": null,
  "is_territorial": true,
  "is_progressive": false,
  "is_flat_tax": true,
  "exemption_threshold": null,
  "data_quality": "high",
  "data_sources": ["https://mof.gov.ae/"],
  "updated_at": "2025-01-15T10:30:00Z",
  "ai_analysis": {
    "crypto_score": 95,
    "nomad_score": 88,
    "key_advantages": ["No personal income tax", "0% crypto tax"],
    "key_disadvantages": ["High cost of living"]
  }
}

💡 Note: Tax rates are stored as decimals (0.28 = 28%, not 28). Multiply by 100 to display as percentages.

Code Examples

JavaScript / TypeScript

// Fetch all countries
const response = await fetch('https://cryptonomadhub-prod-1.onrender.com/regulations');
const countries = await response.json();

// Filter for 0% tax countries
const zeroTax = countries.filter(c => c.cgt_short_rate === 0);
console.log(`Found ${zeroTax.length} countries with 0% tax`);

// Get specific country
const uae = await fetch('https://cryptonomadhub-prod-1.onrender.com/regulations/AE')
  .then(res => res.json());
console.log(`UAE tax rate: ${uae.cgt_short_rate * 100}%`);

Python

import requests

# Fetch all countries
response = requests.get('https://cryptonomadhub-prod-1.onrender.com/regulations')
countries = response.json()

# Filter for 0% tax countries
zero_tax = [c for c in countries if c['cgt_short_rate'] == 0]
print(f"Found {len(zero_tax)} countries with 0% tax")

# Get specific country
uae = requests.get('https://cryptonomadhub-prod-1.onrender.com/regulations/AE').json()
print(f"UAE tax rate: {uae['cgt_short_rate'] * 100}%")

cURL

# Get all countries
curl https://cryptonomadhub-prod-1.onrender.com/regulations

# Get with AI analysis
curl "https://cryptonomadhub-prod-1.onrender.com/regulations?include_analysis=true"

# Get specific country
curl https://cryptonomadhub-prod-1.onrender.com/regulations/AE

# Download to file
curl -o tax-data.json https://cryptonomadhub-prod-1.onrender.com/regulations