Board Rate
Your exchange's price board: the buy and sell rate for every currency, the default basis for trades and every valuation in the app. Rates are either entered manually or read automatically from an API every few minutes — like the digital board over a shop's door, but wired into the app's brain.
When do you come to this page?
- In the morning, to set the day's rates (if you don't have an automatic API).
- When the market has moved and you want to change a rate manually, fast.
Where This Page Fits
- Automatic-reading settings (API address/token, buy/sell spread, rounding): Rate Settings.
- The default rate on the Buy & Sell form comes from this very board.
- "Rate change effect (FX revaluation)" and the valuation of positions and reports are done using this board's rates.
Notes
- "Update from API" only refreshes currencies whose API option is enabled.
- While automatic updating is on, currencies ticked "From API" in "Board rate settings" are read from the API periodically and are only displayed here (API badge). Unticked currencies ("Manual" badge) — e.g. items that are not really currencies, such as tickets or hotel rooms — are priced manually on this page and saved with "Save manual currency rates"; automatic updating never touches them.
- The buy/sell spread and the number of rounding digits are configurable per currency — the rounded number is what's shown everywhere.
- When entering rates manually, the buy rate cannot be higher than the sell rate (equal is allowed). If you enter only one side, the board is one-sided and that number is used for valuation and for measuring a trade's distance from the board.
- Rate history is recorded only when the rounded rate actually changes. Document rates are stored on the documents themselves.
- A backdated document is valued at the market rate of that day with your own price coefficient and addend, not at today's board rate. If there is no close rate for that day, its value comes from the average purchase cost of that currency.
Publish rates
The Publish rates button above the table (for rate managers) gets your board to customers. The numbers are the board's own, and a side you are not quoting shows "No quote". Groups are sent with a random 20 to 40 second gap so the same message does not go out back to back; the estimated time shows under the groups. If you pick more than 20 groups, the window warns about the risk of the WhatsApp line being limited or banned. The TV link is created and copied in the same window, and you can open this window from Ctrl+K. You can round rates for customers: pick a step for each currency (for example 100 turns 297,583 into 297,600) and set the direction to “in the exchange’s favour” or “nearest number”. Rounding applies only to the WhatsApp card and the TV; the board and document rates keep the exact number.
- Image card: tick the currencies you want; if you tick none, the card shows the whole board. See it with Preview card and take it for your WhatsApp status with Download image.
- Send to groups: search for and add groups, save, then press Send to groups. If a rate is stale or suspicious, the window warns you and it goes only if you confirm. The card goes through the WhatsApp send queue and appears in the send report as "Rate card". The text under the card is editable in the WhatsApp message templates as "Text under the rate card".
- Language of each group: each group gets the card and its text in the language of the customer linked to it. A group with no linked customer, or with customers of different languages, gets the default language. The preview and the image download use the default language.
- Automatic sending: set up to three times a day. On working days the card goes at that time from the WhatsApp line of the person who saved. If a rate is stale or suspicious, or automatic updating has stopped, that send does not go out, and this window says so.
- TV board: Create link gives you a full-screen address that opens without signing in and refreshes every minute; open it in the browser of your shop TV or monitor. Only the ticked currencies are shown. The age of the rates is at the top; if the connection drops, the rates dim and the age counts from the last successful read. Create a new link cancels the previous one.
Posting to WhatsApp status directly from the app is not available; download the image and post it yourself.
Rate source and price unit
When rates come from the Nexto service, Source: Tehran market appears above the table; this is the Tehran market cross rate, not your own city's market. An exchange outside Iran gets a manual board when it picks a non-Iranian reference currency, and automatic updating is turned off; you can turn it on in the system settings at any time.
If your market quotes per 100 or 1,000 units (like dinars per 100 dollars), change the Price unit column in the board rate settings. The board and the dashboard widget show prices in that unit, and manual entry, "Manual mid", the addend and the settings preview use it too ("per 100" next to the currency). Rates in the trade form, the customer panel and reports stay per one unit.
Stale rates
The Last change / last confirmed column shows two things separately: when the price last changed and, for API currencies, when the rate source last confirmed that number. In a quiet market the price may not change for hours, and that is normal. If no confirmation arrives for a while during working hours, an amber "not updated for X min" badge appears next to the currency. The same badge shows in the dashboard board-rate widget and in the buy & sell form preview, and it does not block saving. If no read round succeeds for a while, the green label above the table changes to "Automatic update has stopped". Working hours are the days and hours set in the customer panel settings.
Suspicious rates
If a new number from the rate source jumps abnormally, it is not written to the board and the board stays on the last sound number. A line above the table shows what arrived, and the rate manager's bell reports it too. If the source corrects itself in the next round, everything goes back to normal automatically. If it is a real market jump, Accept this rate puts the number on the board; when several currencies are held together, Accept all accepts them at once. If a number has changed since you saw it, it is not accepted and that currency keeps waiting. Changing the coefficient, addend or spread in the settings does not count as a jump, and when you change a currency's source yourself (turning "From API" on or changing the symbol), the first number is accepted without this check.
When entering rates manually, a rate that differs from the current board by more than 15% opens an "Are you sure?" window showing the old and new values, and it is saved only if you confirm. The same window applies to "Manual mid" in the board rate settings.
Board vs. actual trades
The "Board calibration" table (visible to rate managers only) compares your real trades with the board and shows which currency's price coefficient or spread is worth adjusting. Applying the suggestions is up to you.
In this table (rate managers only) the Needs adjusting chip means that currency's “center” is far from zero. The Apply button next to the suggested coefficient sets that figure on the currency after one confirmation and rebuilds the board rate with it. Measuring for that currency then restarts from new trades, so its row leaves the table until a few new trades arrive. The High mark next to the configured spread means it is at least twice the actual spread.
No quote
Next to the buy and sell cells of each currency there is a small power icon labelled “Stop quoting” (only for users allowed to change rates). One click temporarily turns off that side of the board, for example “we are not buying coins, but we are selling”. Buy and sell are turned off separately. The saved rate is not touched. The red “No quote” mark appears only while that side is off: the rate is dimmed and struck through, and the board, the dashboard widget and the customer panel show this instead of the number. If you record a trade on that side in the buy & sell form, the preview warns you. Recording is not blocked, because phone and negotiated trades are still possible. To bring it back, click the same icon (“Quote again”).
Mazaneh bar (gold dealers)
If both 18K gold and toman are active, a bar above the board shows the 18K gram price and the mazaneh in thousand toman, with your buy (green) and sell (red). Mazaneh equals the price of one 18K gram × 4.3318 (one mesghal of 705). It does not matter whether the reference currency is gold or toman. The button next to the bar opens the Gold calculator.
Branded bars
Bars, like coins, are “count currencies” (no decimals): stock and trades are counted in pieces, not grams. The currency catalogue has 1, 5, 10, 20, 50 and 100 gram bars ready. Their price comes from 24K gold times the weight (price coefficient = grams). Name the brand yourself, for example “Golestaneh 5 g”, and apply the making charge or brand premium in Board Rate Settings with a coefficient or an addition.
Board price currency
If you quote in toman but read profit in dollars or dirhams, choose the board price currency in the board rate settings. The board, dashboard, WhatsApp card and TV are priced in it, while profit and the ledger stay in the reference currency. Feed currencies are calculated at full precision with only their own spread. Enter manual currencies directly in that currency; the reference rate is built from it. In the board rate settings the API price and preview also show in this currency, and the rounding column sets the board price step; the reference rate rounding stays as it was. If the price currency moves more than half a percent and a manual currency has not been re-entered, the board warns you. In the trade form, when one side is this currency, the suggested rate is the board price, and profit is still calculated in the reference currency. A currency that does not come from the API has two bases for its manual price: “Board currency”, where you enter the price in that currency on the board page, or “Reference currency”, where the price is entered in the reference currency as before and the board price is built from it.