TickAtlas
GET /v1/heatmap Premium (2x)

Currency Heatmap

Retrieve a real-time currency strength heatmap across the 8 major currencies (USD, EUR, GBP, JPY, CHF, AUD, CAD, NZD). Each currency is scored on a 0-10 strength scale with trend classification and period-over-period change, giving you a macro-level view of which currencies are dominating and which are weakening.

How Currency Strength Is Derived

Currency strength is calculated by aggregating the performance of each currency across all available pairs where it appears. For example, USD strength reflects a composite of EURUSD, GBPUSD, USDJPY, USDCHF, AUDUSD, USDCAD, and NZDUSD movements over the selected timeframe. This cross-pair aggregation eliminates single-pair bias and produces a reliable measure of absolute currency momentum.

Field Description
strengthScore from 0.0 (extremely weak) to 10.0 (extremely strong), representing composite performance across all pairs
trendClassified as bullish (strength rising), bearish (strength falling), or neutral (stable)
changePeriod-over-period change in the strength score (positive = strengthening, negative = weakening)

Parameters

Parameter Type Required Description
typestringNoHeatmap type. Default: strength. Currently only strength is supported.
timeframestringNoAnalysis timeframe: H1, H4, D1, W1. Default: H4.

Available Timeframes

Each timeframe reveals a different layer of currency momentum. Combining multiple timeframes (e.g., D1 for direction, H1 for entry timing) produces higher-conviction trade setups.

Timeframe Insight
H1 Intraday momentum — identifies short-term currency shifts for scalping and day trading
H4 Swing bias — reveals medium-term strength trends for swing trade entries and exits
D1 Daily directional bias — confirms the dominant currency flow for the trading session
W1 Macro trend — exposes structural strength shifts for position trading and portfolio allocation

Example Request

cURL

cURL 
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://tickatlas.com/v1/heatmap?type=strength&timeframe=H4"

Python — Find the Strongest vs. Weakest Pair

Python 
import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://tickatlas.com"

# Fetch H4 currency strength heatmap
resp = requests.get(
    f"{BASE}/v1/heatmap",
    headers={"X-API-Key": API_KEY},
    params={"type": "strength", "timeframe": "H4"}
)
data = resp.json()["data"]

# Find the strongest and weakest currencies
currencies = data["currencies"]
strongest = max(currencies, key=lambda c: currencies[c]["strength"])
weakest = min(currencies, key=lambda c: currencies[c]["strength"])

print(f"Strongest: {strongest} ({currencies[strongest]['strength']})")
print(f"Weakest:   {weakest} ({currencies[weakest]['strength']})")
print(f"Suggested pair: {strongest}{weakest}")

JavaScript

JavaScript 
const API_KEY = "YOUR_API_KEY";

const res = await fetch(
  "https://tickatlas.com/v1/heatmap?type=strength&timeframe=H4",
  { headers: { "X-API-Key": API_KEY } }
);
const { data } = await res.json();

// Log each currency with its trend
for (const [currency, info] of Object.entries(data.currencies)) {
  console.log(`${currency}: ${info.strength}/10 (${info.trend}, ${info.change >= 0 ? "+" : ""}${info.change})`);
}

Success Response

200 OK 
{
  "success": true,
  "data": {
    "type": "strength",
    "timeframe": "H4",
    "currencies": {
      "USD": { "strength": 7.8, "trend": "bullish", "change": 0.5 },
      "EUR": { "strength": 5.2, "trend": "neutral", "change": -0.1 },
      "GBP": { "strength": 6.4, "trend": "bullish", "change": 0.3 },
      "JPY": { "strength": 3.1, "trend": "bearish", "change": -0.8 },
      "CHF": { "strength": 4.9, "trend": "neutral", "change": 0.0 },
      "AUD": { "strength": 4.2, "trend": "bearish", "change": -0.4 },
      "CAD": { "strength": 5.7, "trend": "neutral", "change": 0.2 },
      "NZD": { "strength": 3.8, "trend": "bearish", "change": -0.6 }
    },
    "timestamp": "2026-04-04T14:30:00Z"
  }
}

Use Cases

Currency Strength Strategies

Pair the strongest currency against the weakest for maximum directional conviction. A USD strength of 7.8 against JPY at 3.1 suggests USDJPY long offers the highest momentum alignment.

Pair Selection Optimization

Instead of scanning dozens of charts, use the heatmap to instantly identify which pairs have the largest strength differential. Focus your analysis only on pairs where the currencies are moving in opposite directions.

Trend Confirmation

Validate technical signals against the heatmap. A bullish breakout on GBPUSD is more reliable when GBP shows bullish strength and USD shows bearish weakness across multiple timeframes.

Portfolio Hedging Decisions

Monitor correlated currency exposure across your open positions. If multiple trades are long on a currency that suddenly shifts to bearish trend, the heatmap provides early warning to hedge or reduce exposure.

Notes

  • The strength scale runs from 0.0 (extremely weak) to 10.0 (extremely strong). A score near 5.0 indicates neutral positioning relative to other currencies.
  • Trend classification is derived from the direction and magnitude of the strength change: sustained positive change marks bullish, sustained negative marks bearish, and minimal change marks neutral.
  • This endpoint carries a Premium (2x) billing weight due to the cross-pair computation involved.
  • A correlation mode is planned for a future release, which will expose inter-currency correlation matrices alongside strength scores. It is not yet available.

Related