API Documentation

Overview

The RTP Dashboard API provides read-only access to transaction data, time series, and metadata for 33 real-time payment systems worldwide. Data is sourced from central banks, payment operators, and BIS CPMI statistics.

All responses are JSON. No authentication is required.

Base URL

https://rtpdashboard.net/.netlify/functions/api

Endpoints

Response Fields

Example Response

{
  "data": {
    "upi": {
      "system": "upi",
      "transaction_count": 21634670000,
      "transaction_value_usd": 320876837684,
      "period_end": "2025-12-01",
      "data_frequency": "monthly",
      "source": "NPCI",
      "source_url": "https://www.npci.org.in/product/upi/product-statistics",
      "source_published": "2026-01-12"
    }
    // ... one entry per system with confirmed data
  },

  "timeseries": {
    "upi": [
      {
        "period": "2021-01-01",
        "volume": 2302730000,
        "value_usd": 58189529040,
        "value_usd_fixed": 49471037853,
        "value_local": 4311818900000,
        "fx_year": 2020
      }
      // ... more data points, ascending by period
    ]
  },

  "systems": {
    "upi": {
      "name": "UPI",
      "country": "India",
      "flag": "\ud83c\uddee\ud83c\uddf3",
      "region": "asia_pacific",
      "currency": "INR",
      "launched": 2016,
      "type": "Account Transfer + QR",
      "operator": "NPCI",
      "settlement": "Instant",
      "rail": "UPI",
      "population": 1430000000,
      "participants": 300,
      "infra": {
        "qr": "yes",
        "wallet": "yes",
        "twentyFourSeven": true,
        "crossBorder": "yes",
        "iso20022": "no",
        "requestToPay": "yes",
        "openApi": "yes",
        "proxy": "yes"
      },
      "description": "Unified Payments Interface..."
    }
  },

  "fx_historical": {
    "INR": { "2009": 48.4052667, "2010": 45.7258121, "2024": 83.6692816, "2025": 87.1584484 },
    "USD": { "2009": 1, "2025": 1 }
    // local currency units per US dollar, period average
  },

  "fx_basis": {
    "default": "each_year",
    "constant_basis_year": 2025,
    "source": {
      "source": "World Bank, Official exchange rate (LCU per US$, period average), indicator PA.NUS.FCRF",
      "underlying_source": "IMF International Financial Statistics",
      "url": "https://data.worldbank.org/indicator/PA.NUS.FCRF",
      "source_last_updated": "2026-07-13"
    },
    "exceptions": {}
  },

  "systems_with_data": 37,
  "total_systems": 37,
  "updated_at": "2026-07-28T09:14:22.108Z"
}

Data Entry Fields

Each entry in data is the most recent confirmed period for that system, and contains:

Timeseries Point Fields

Each point in a timeseries array contains:

System Metadata Fields

Each entry in systems contains:

System IDs

The API uses the following 37 system identifiers as keys in data, timeseries, and systems:

Usage Example

// Fetch all data
const response = await fetch('https://rtpdashboard.net/.netlify/functions/api/latest');
const { data, timeseries, systems, fx_historical, fx_basis } = await response.json();

// Latest confirmed period for UPI
console.log(data.upi.transaction_count, data.upi.period_end);
// => 21634670000 '2025-12-01'

// Length of the Pix series
console.log(timeseries.pix.length);

// System metadata
console.log(systems.fps_uk.operator);
// => "Pay.UK"

// The rate a given point was converted at — local currency per US dollar
const point = timeseries.upi.at(-1);
console.log(fx_historical[systems.upi.currency][point.fx_year]);
// => 87.1584484

// Annual totals for one system, on either basis.
// Skip nulls rather than coercing them: a null is an unpublished figure, not a zero.
function annualTotals(id, field = 'value_usd') {
  const out = {};
  for (const d of timeseries[id]) {
    if (d[field] == null) continue;
    const year = d.period.slice(0, 4);
    out[year] = (out[year] || 0) + d[field];
  }
  return out;
}

annualTotals('nip');                    // contemporaneous dollars
annualTotals('nip', 'value_usd_fixed'); // every year at the fx_basis.constant_basis_year rate
annualTotals('nip', 'value_local');     // the published record

// Note: a year is only complete if every period in it is present. For an annual
// system reporting on a fiscal year, `period.slice(0, 4)` is the year the period
// ENDED in, not a calendar year — check `systems[id]` and `data[id].data_frequency`
// before comparing across systems.

Rate Limits

Notes

• Every figure is one an authoritative source published. Nothing is extrapolated from a growth rate, interpolated across a gap, or derived from an average transaction size. Where a source has published nothing, the field is null or the period is absent. See the methodology in full.
• Local currency is the record. Both USD fields are derived from value_local, never the reverse. Where they disagree, value_local is the figure to use.
• USD figures are for comparison only, and for volatile currencies the two bases can differ by several times over. Which one is right depends on your question — currency conversion sets out both.
• Rates do not move once published. The rate for a completed year is written once and left alone, so a 2021 dollar figure returned today will be the same figure next year.
• Only completed periods appear. A part-year is never returned as though it were a full one, and a fiscal year appears once its own end date has passed.
• Reporting granularity varies by system — see data_frequency. So does history: Faster Payments (2008) goes back further than FedNow (2023).
• Responses are cached for one hour. The underlying data changes monthly at most, so caching further is safe.
• This API is for informational purposes only. See the dashboard disclaimer for full terms.