--- title: "The FX book" description: "A shop that needs 99 dollars in yen does not buy a second vendor. Sugra Finance already has 151 official daily rates and convert on the same key as the quote, from named central banks." seo_title: "Sugra Finance: the FX book" seo_description: "Sugra Finance already has 151 official daily FX rates and convert on the same key as the quote. A shop does not buy a second currency API." slug: the-fx-book status: published published_at: 2026-09-06 updated_at: 2026-09-07 author: Arman Obosyan author_url: https://sugra.systems/about section: general primary_keyword: sugra finance fx rates hero_image: /blog/images/posts/the-fx-book-hero.jpg hero_alt: "Sugra API, Sugra Finance, Markets. Title: The FX book. 151 official rates, already in the key." og_image: /blog/images/posts/the-fx-book-hero.jpg tags: - finance - forex - api - markets --- You have a shop. A jacket is 99 dollars. A customer in Tbilisi, Tokyo or Tashkent wants that number in their currency before they pay. This is a display problem. The market has trained you to solve it by buying a currency API: a second vendor, a second key, a second bill, for the privilege of printing a number next to a price. If you already hold a Sugra key, you do not buy that product. The official daily book is a module of [Sugra Finance](/blog/sugra-finance), on the same key as the quote, the 13F, the shorts. Finance is one of [seven directions](https://sugra.systems/api/family). Convert reads that same book. ## Where the print comes from The daily panel is Banca d'Italia. If Italy is silent, the whole book falls to the Central Bank of Uzbekistan. If both are silent, ECB and Narodowy Bank Polski remain. Weekly cadence is still the Polish Table B. That is the provenance. Named central banks, not a blended commercial feed. The euro snapshot at `/forex/latest` is a different endpoint: EUR base, 29 codes, ECB. Leave it. This article is the shelf. ## What a dedicated FX API costs These four exist to sell you the book and nothing else: ![What a dedicated FX API costs: Fixer, CurrencyLayer, Open Exchange Rates and ExchangeRate-API, free and paid plans as published on 2026-09-06](/blog/images/posts/the-fx-book/fx-api-prices.jpg) *Prices as published on 2026-09-06. Reference only: specialised FX products. Sugra is not in the table because the book is not a SKU.* Sugra Free is 50 requests a day and already includes this book, plus Macro, Entity, News, Earth, the rest of the catalog. Sugra Pro is 59 dollars for 50,000 requests **a day**. Their 59 dollars buys the currency feed alone. They update more often on paid plans. Ours is a daily official fix. For a storefront that needs to show yen, that is the right clock. For a payment you actually send, it is the wrong clock. The payload says so: `basis` is `central-bank reference, not tradable`. They often advertise 170 currencies. We serve 151 unique ISO codes from one official book. Metals are dropped. Four Banca d'Italia rows print as unparseable and leave the default book: the Russian rouble, the Belarusian rouble, the Iranian rial, the North Korean won. The count is smaller because the book is honest. ## A price on the shop ``` GET /api/v1/forex/rates?base=USD ``` ```bash curl -H "x-api-key: YOUR_API_KEY" \ "https://sugra.ai/api/v1/forex\ /rates?base=USD" ``` Live on 2026-09-06: 151 ISO codes, one panel, `as_of` 2026-09-04. USD is 1.0. EUR is 0.8604. JPY is 156.2468. Georgian lari is 2.6159. Uzbek som is 11,795.62. The calendar was Saturday; the book is Friday. That is what a daily official print looks like. It is dated, not late. ``` GET /api/v1/forex/convert ?from=USD&to=EUR&amount=99 ``` ```bash curl -H "x-api-key: YOUR_API_KEY" \ "https://sugra.ai/api/v1/forex\ /convert?from=USD&to=EUR\ &amount=99" ``` ```json { "from_currency": "USD", "to_currency": "EUR", "amount": 99.0, "result": 85.18, "rate": 0.8604, "date": "2026-09-04", "basis": "central-bank reference, not tradable" } ``` 99 dollars is 85.18 euro on that fix, 15,468 yen, 258.97 lari, 1,167,766 som. ![99 USD converted on the official book: 85.18 EUR, 15,468 JPY, 258.97 GEL, 1,167,766 UZS, as of 2026-09-04](/blog/images/posts/the-fx-book/shop-convert.jpg) *Data: [Sugra API](https://sugra.ai) - one request, nothing else: `GET /api/v1/forex/convert?from=USD&to=EUR&amount=99`.* The runnable copy is recipe 17 in the public cookbook: [forex_shop_convert.py](https://github.com/Sugra-Systems/sugra-api-cookbook/blob/main/recipes/17_forex_shop_convert.py). Same envelope as CPI, as a 13F, as a weather point. Recipe 10 in that folder is the BIS long-run series versus the dollar, a different job. ## An invoice in the other direction The shop prices a ticket in the customer's currency. The finance team does the reverse: a 12,000 euro supplier invoice, booked in dollars. ``` GET /api/v1/forex/convert ?from=EUR&to=USD&amount=12000 ``` ```bash curl -H "x-api-key: YOUR_API_KEY" \ "https://sugra.ai/api/v1/forex\ /convert?from=EUR&to=USD\ &amount=12000" ``` On the same 2026-09-04 print: 13,947.00 USD. Same book, opposite direction, no second vendor. An agent that has to answer "what is 99 dollars in yen" uses the shop call. It should cite the date on the row, not invent a rate from memory. It is not for sending the payment. The bank that moves the money has its own rate, and that rate is a trade. This book is how you orient before you get there. ## What is next A faster official book, for a checkout that cannot wait for the daily fix. And a comparison of official cross-rates across central banks: the same pair printed two ways. Banca d'Italia's dollar-euro versus the path through a third currency on another central-bank print. That is a discrepancy, not a trade you can execute. Neither is in this endpoint today. Stay tuned. --- Not a trade. Values pulled 2026-09-06 from [sugra.ai](https://sugra.ai). Book date 2026-09-04. Previous: [Sugra Finance](/blog/sugra-finance). Family: [seven directions, one key](https://sugra.systems/api/family#sugra-finance).