{
  "version": "1.0",
  "base_url": "https://apitoll.io",
  "note": "For sandbox calls use path as-is. For production replace /sandbox/ with /.",
  "services": [
    {
      "id": "fx-rates",
      "description": "Daily ECB reference exchange rates between two currencies",
      "path": "/v1/sandbox/fx/{base}/{quote}",
      "inputs": ["base", "quote"],
      "input_descriptions": {
        "base": "3-letter ISO 4217 source currency e.g. USD",
        "quote": "3-letter ISO 4217 target currency e.g. EUR"
      },
      "price_usd": 0.001,
      "triggers": ["exchange rate", "FX", "convert", "currency"]
    },
    {
      "id": "fx-rates-list",
      "description": "All 30+ FX rates against a single base currency in one call",
      "path": "/v1/sandbox/fx/{base}",
      "inputs": ["base"],
      "input_descriptions": {
        "base": "3-letter ISO 4217 base currency e.g. USD"
      },
      "price_usd": 0.001,
      "triggers": ["all rates", "rates list", "all exchange rates"]
    },
    {
      "id": "bin-lookup",
      "description": "Card-issuer metadata for a BIN — scheme, type, country, bank name",
      "path": "/v1/sandbox/bin/{bin}",
      "inputs": ["bin"],
      "input_descriptions": {
        "bin": "6-8 digit card BIN / IIN"
      },
      "price_usd": 0.002,
      "triggers": ["BIN", "card", "bank issued", "card lookup", "issuer", "country for card"]
    },
    {
      "id": "country-data",
      "description": "ISO codes, capital, dialling code, and timezones for a country",
      "path": "/v1/sandbox/country/{iso2}",
      "inputs": ["iso2"],
      "input_descriptions": {
        "iso2": "ISO 3166 alpha-2 country code e.g. ZA, JP, US"
      },
      "price_usd": 0.001,
      "triggers": ["country", "dialling code", "capital", "timezone", "ISO code"]
    },
    {
      "id": "country-data-resolve",
      "description": "Look up a country from a fuzzy name, alias, or ISO code",
      "path": "/v1/sandbox/country/resolve/{input}",
      "inputs": ["input"],
      "input_descriptions": {
        "input": "Fuzzy country name or code e.g. South Africa, ZAF, S Africa"
      },
      "price_usd": 0.001,
      "triggers": ["country name", "find country", "which country is"]
    },
    {
      "id": "holidays",
      "description": "Public, bank, and regional holidays for a country and year",
      "path": "/v1/sandbox/holidays/{iso2}/{year}",
      "inputs": ["iso2", "year"],
      "input_descriptions": {
        "iso2": "ISO 3166 alpha-2 country code",
        "year": "4-digit year e.g. 2026"
      },
      "price_usd": 0.001,
      "triggers": ["holiday", "public holiday", "bank holiday", "is today a holiday"]
    },
    {
      "id": "ip-geolocation",
      "description": "City, ASN, coordinates, and country for an IP address",
      "path": "/v1/sandbox/ip/{address}",
      "inputs": ["address"],
      "input_descriptions": {
        "address": "IPv4 or IPv6 address e.g. 8.8.8.8"
      },
      "price_usd": 0.002,
      "triggers": ["IP", "geolocation", "where is IP", "ASN", "IP address location"]
    }
  ]
}