EMpulse Street FX Index

The latest street exchange rate of an emerging-market currency against the US dollar (USDT) from the EMpulse Street FX Index, or the rate on a given day: rate (mid), buy, sell, spread, 1/7/30-day changes, confidence class and a ready citation. Free access is delayed by one day; a Pro key gives the current day.

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "ISO 4217 code, for example EGP, NGN, ARS",
      "maxLength": 3,
      "minLength": 3,
      "title": "Currency",
      "type": "string"
    },
    "date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "UTC day, YYYY-MM-DD; default: the latest day available to your plan",
      "title": "Date"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Language of the citation text (ISO 639-1 code of a site language: en, ru, es, ar, tr, uz); default English",
      "title": "Lang"
    }
  },
  "required": [
    "currency"
  ],
  "title": "get_street_rateArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_street_rateDictOutput"
}

Daily street rates of a currency between two dates (inclusive, UTC days, at most 400 days per call): rate, buy, sell, confidence per day, plus a summary (first, last, change, low, high). Defaults: the last 30 days up to the latest day of your plan.

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "ISO 4217 code, for example EGP, NGN, ARS",
      "maxLength": 3,
      "minLength": 3,
      "title": "Currency",
      "type": "string"
    },
    "from_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "first day, YYYY-MM-DD",
      "title": "From Date"
    },
    "to_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "last day, YYYY-MM-DD",
      "title": "To Date"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Language of the citation text (ISO 639-1 code of a site language: en, ru, es, ar, tr, uz); default English",
      "title": "Lang"
    }
  },
  "required": [
    "currency"
  ],
  "title": "get_rate_historyArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_rate_historyDictOutput"
}

Every currency of the EMpulse Street FX Index with its status (active, or coverage in progress while market sources are being added), the confidence class and the number of sources behind the latest day, coverage since, and whether your plan covers it.

{
  "type": "object",
  "properties": {},
  "title": "list_currenciesArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "list_currenciesDictOutput"
}

How far the street rate of a currency is from its official central-bank rate: official rate and its publication day, street rate, premium in percent, 7-day average and 30-day maximum. Pro and Enterprise keys.

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "ISO 4217 code, for example EGP, NGN, ARS",
      "maxLength": 3,
      "minLength": 3,
      "title": "Currency",
      "type": "string"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Language of the citation text (ISO 639-1 code of a site language: en, ru, es, ar, tr, uz); default English",
      "title": "Lang"
    }
  },
  "required": [
    "currency"
  ],
  "title": "get_official_vs_streetArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_official_vs_streetDictOutput"
}

Early warning from the street: a none / watch / alert flag per currency when the street market shows stress (a run of weakening days, a 7-day move in the top decile of the currency's own year, a buy–sell spread blow-out), with the rules that fired and the day the episode started. One currency or all. Pro and Enterprise keys.

{
  "type": "object",
  "properties": {
    "currency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ISO 4217 code; omit for all",
      "title": "Currency"
    }
  },
  "title": "get_stress_signalsArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_stress_signalsDictOutput"
}

A dated feed of events that move street FX in emerging markets — devaluations, cash and withdrawal limits, bans of stablecoin services, currency controls, payment outages — each a short quotation with a link to the public source. Filter by country or currency; `days` back from the latest day of your plan (free: 48-hour delay).

{
  "type": "object",
  "properties": {
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "country name in English",
      "title": "Country"
    },
    "currency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ISO 4217 code",
      "title": "Currency"
    },
    "days": {
      "anyOf": [
        {
          "maximum": 90,
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "1–90, default 7",
      "title": "Days"
    }
  },
  "title": "get_fx_eventsArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_fx_eventsDictOutput"
}

The street rate of a currency per UTC hour for one day, with the day's summary (vwap, high, low, hours, busiest hour), for every currency with hourly market data; each hour says its component (transaction_based / multi_source / combined) and quality. Pro and Enterprise keys.

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "ISO 4217 code, for example EGP, NGN, ARS",
      "maxLength": 3,
      "minLength": 3,
      "title": "Currency",
      "type": "string"
    },
    "date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "UTC day, YYYY-MM-DD; default: today",
      "title": "Date"
    }
  },
  "required": [
    "currency"
  ],
  "title": "get_hourlyArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_hourlyDictOutput"
}

Which payment methods work in a country today and how reliably: for every method class (cards, bank transfers, instant transfers, e-wallets, mobile money, cash, crypto, direct local rails) and direction (pay-ins, payouts) a status — healthy / degraded / outage / no_data — with the time it began and a ready citation. Free level: the free currencies, one day behind. Pro keys of the Rail Health Index: today, every currency, the health index (100 = the rail's own norm), availability, supply.

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "ISO 4217 code, for example EGP, NGN, ARS",
      "maxLength": 3,
      "minLength": 3,
      "title": "Currency",
      "type": "string"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Language of the citation text (ISO 639-1 code of a site language: en, ru, es, ar, tr, uz); default English",
      "title": "Lang"
    }
  },
  "required": [
    "currency"
  ],
  "title": "get_rail_healthArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_rail_healthDictOutput"
}

Every change of status of a payment method class — degraded, outage, back to healthy — over the last `days` (default 30), newest first, each with a one-line summary ("Bank transfers (pay-ins) in Egypt: degraded since 2026-10-24 14:00 UTC"). Optionally one currency. Pro keys of the Rail Health Index.

{
  "type": "object",
  "properties": {
    "currency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ISO 4217 code; omit for all",
      "title": "Currency"
    },
    "days": {
      "anyOf": [
        {
          "maximum": 90,
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "1–90, default 30",
      "title": "Days"
    }
  },
  "title": "get_rail_incidentsArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_rail_incidentsDictOutput"
}

Where payment demand in emerging markets is not being served. Without a currency: the ranking of covered markets by the share of demand no rail served, with the trend. With a currency: its rank and trend (free level, one day behind); Pro keys of the Unmet Demand Map also get the unmet share, the not-connected share, the index against the 90-day norm, the reason classes and the hours of day, per direction and method class.

{
  "type": "object",
  "properties": {
    "currency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ISO 4217 code; omit for the ranking",
      "title": "Currency"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Language of the citation text (ISO 639-1 code of a site language: en, ru, es, ar, tr, uz); default English",
      "title": "Lang"
    }
  },
  "title": "get_unmet_demandArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_unmet_demandDictOutput"
}

Where and when the dollar actually moves through USDT: the liquidity index of a currency (0–100, 50 = the market's own 90-day norm) with a ready citation. Free level: yesterday, the free currencies. Pro keys of USDT Liquidity & Premium: today, every currency, the pay-in / payout balance, the spread, the active hours of day, the premium over the official rate and the supply class.

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "ISO 4217 code, for example EGP, NGN, ARS",
      "maxLength": 3,
      "minLength": 3,
      "title": "Currency",
      "type": "string"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Language of the citation text (ISO 639-1 code of a site language: en, ru, es, ar, tr, uz); default English",
      "title": "Lang"
    }
  },
  "required": [
    "currency"
  ],
  "title": "get_usdt_liquidityArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_usdt_liquidityDictOutput"
}

What the news says about the country of a currency, day by day. Without a currency: the map of covered currencies ranked by the 7-day fall in the tone of the news. With a currency: its latest day — a label (negative … positive) and the direction of the trend (free level, one day behind); Pro keys of EM FX News & Sentiment also get the score (−1 … 1), the index against the country's own 90-day norm, the number of articles, the early signal when the tone falls while the street rate is calm, the global topics (macro, crypto, markets) and the link between the tone and the next 1-, 3- and 7-day moves of the street rate, with confidence.

{
  "type": "object",
  "properties": {
    "currency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "ISO 4217 code; omit for the map",
      "title": "Currency"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Language of the citation text (ISO 639-1 code of a site language: en, ru, es, ar, tr, uz); default English",
      "title": "Lang"
    }
  },
  "title": "get_news_sentimentArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_news_sentimentDictOutput"
}

The ladder of rates a currency has on its latest day: the central bank's official rate, the interbank rate, what banks quote (buy / sell), the customs rate duties are computed at, what international cards settle at and the street rate — each with its publication day, the number of sources and a confidence class — the gap of the street over every rung, the width of the ladder, its 7- and 30-day trend and a widening signal (none / watch / alert), with a ready citation. A rung the country does not publish on its own says which rung it equals. Free level: the official, customs and street rungs of the free currencies, one day behind. Paid keys of the FX Rate Stack: every rung, every active currency, today.

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "ISO 4217 code, for example EGP, NGN, ARS",
      "maxLength": 3,
      "minLength": 3,
      "title": "Currency",
      "type": "string"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Language of the citation text (ISO 639-1 code of a site language: en, ru, es, ar, tr, uz); default English",
      "title": "Lang"
    }
  },
  "required": [
    "currency"
  ],
  "title": "get_rate_stackArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_rate_stackDictOutput"
}

The rate between two emerging-market currencies as quoted in public exchange listings between the two countries (units of `b` per 1 `a`), the day's range, the number of sources and the confidence class, next to the cross rate implied by the two dollar legs of the index and the corridor premium (positive: going directly is dearer than through the dollar). Pro and Enterprise keys of the index.

{
  "type": "object",
  "properties": {
    "a": {
      "description": "ISO 4217 code, for example EGP, NGN, ARS",
      "maxLength": 3,
      "minLength": 3,
      "title": "A",
      "type": "string"
    },
    "b": {
      "description": "ISO 4217 code, for example EGP, NGN, ARS",
      "maxLength": 3,
      "minLength": 3,
      "title": "B",
      "type": "string"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Language of the citation text (ISO 639-1 code of a site language: en, ru, es, ar, tr, uz); default English",
      "title": "Lang"
    }
  },
  "required": [
    "a",
    "b"
  ],
  "title": "get_corridorArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_corridorDictOutput"
}

How the EMpulse Street FX Index is computed — components, confidence classes, outliers, revisions, coverage rules — as markdown, with the citation format.

{
  "type": "object",
  "properties": {},
  "title": "get_methodologyArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "get_methodologyDictOutput"
}

Issue a free EMpulse API key for an email address, right here: the free currencies, data up to yesterday, 100 calls per day. The key is returned and also emailed with a ready example; send it in the X-API-Key header on this server and on the REST API.

{
  "type": "object",
  "properties": {
    "email": {
      "description": "the address the key is issued to",
      "title": "Email",
      "type": "string"
    }
  },
  "required": [
    "email"
  ],
  "title": "request_free_keyArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "request_free_keyDictOutput"
}