{
  "info": {
    "name": "Bank exchange rates (SBX-BANKFX)",
    "description": "The buying and selling rates Turkish banks show on their own pages, side by side: spreads, the cheapest bank to buy from and the best to sell to, and every rate change.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{SBX_API_KEY}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.servicebox.io",
      "type": "string"
    },
    {
      "key": "SBX_API_KEY",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "List banks",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/bank-fx/banks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "bank-fx",
            "banks"
          ],
          "query": [],
          "variable": []
        },
        "description": "The banks whose rates are read, with the page each is read from, the channel, how many currencies it shows and when it was last read. Free.\n\nCredits: 0"
      }
    },
    {
      "name": "Rate changes over time",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/bank-fx/history?bank=string&currency=string",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "bank-fx",
            "history"
          ],
          "query": [
            {
              "key": "bank",
              "value": "string",
              "description": "A bank id from /bank-fx/banks, e.g. isbank.",
              "disabled": false
            },
            {
              "key": "currency",
              "value": "string",
              "description": "One ISO 4217 code, e.g. USD.",
              "disabled": false
            },
            {
              "key": "start",
              "value": "string",
              "description": "YYYY-MM-DD.",
              "disabled": true
            },
            {
              "key": "end",
              "value": "string",
              "description": "YYYY-MM-DD. Default: today.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "Every change of one bank's rate for one currency between `start` and `end` (UTC days, inclusive; default the last 7 days; at most 31). The first item is the rate that held at `start`. Recorded since 2026-09-29. Use for how one bank's rate for a currency changed over recent days.\n\nCredits: 1"
      }
    },
    {
      "name": "Latest bank rates",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/bank-fx/rates",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "bank-fx",
            "rates"
          ],
          "query": [
            {
              "key": "bank",
              "value": "string",
              "description": "A bank id from /bank-fx/banks, e.g. isbank.",
              "disabled": true
            },
            {
              "key": "currencies",
              "value": "string",
              "description": "Comma-separated ISO 4217 codes, e.g. USD,EUR.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "Each bank's latest buying and selling rate per currency, in TRY, with the spread. Rates are read from the banks' public pages every 5 minutes on weekdays (hourly otherwise); `observedAt` is the last read and `changedAt` when the rate last moved. Filter by `bank` and `currencies`. Use when the user asks what Turkish banks charge or pay for USD, EUR, GBP or another currency, or for one bank's rates. `buying` is what the bank pays you for one unit (you sell); `selling` is what you pay the bank (you buy). For the official TCMB rate use the currency (FX) tools instead.\n\nCredits: 1"
      }
    },
    {
      "name": "Compare banks",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/bank-fx/rates/compare?currency=string",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "bank-fx",
            "rates",
            "compare"
          ],
          "query": [
            {
              "key": "currency",
              "value": "string",
              "description": "One ISO 4217 code, e.g. USD.",
              "disabled": false
            }
          ],
          "variable": []
        },
        "description": "One currency at every bank, cheapest to buy first (lowest selling rate), with `meta.cheapestToBuy` (lowest selling) and `meta.bestToSell` (highest buying). Banks with stale rates are listed but not picked. Use when the user asks which bank is cheapest to buy a foreign currency from (lowest selling rate) or best to sell it to (highest buying rate): one call compares every bank.\n\nCredits: 1"
      }
    }
  ]
}