Skip to main content
Financial

Currency Broker

Currency liquidity, pricing, inventory and API clients

9
Sections
2
Panels
Service Overview

The currency broker module serves liquidity providers who buy and sell foreign currency for club members or API clients — separate from simple exchange rates in wallet. Platform admins onboard brokers and monitor activity; broker staff use the Currency Broker Panel for pricing, inventory, trades, and API clients.

Use this when your club or platform partners with a licensed exchanger that needs inventory tracking, trade approval queues, and programmatic client access.

1
Section 1 of 9

Core concepts

ConceptMeaning
**Broker**Licensed entity operating the broker panel.
**Currency pair**Tradable instruments with buy/sell prices.
**Inventory**Broker's stock per currency — limits auto-execution.
**Trade**Single buy/sell transaction — pending → settled.
**API client**External system with keys calling broker services.
**Client credit**Prepaid balance held by API clients.
Previous sectionNext section
2
Admin ConsoleSection 2 of 9

Broker management

**Menu:** Platform Admin → Business Management → Currency brokers

Register brokers, link clubs, and suspend bad actors.

Prerequisites

  1. Platform admin business module access.
  2. Legal onboarding completed offline.

Page layout

  • Broker list: name, status, linked clubs, trade volume snippet.
  • New broker — company info, contact, initial limits.
  • Actions: activate, suspend, reset credentials.

Step-by-step

  1. Open Currency brokers.
  2. New broker after contract signed.
  3. Link clubs allowed to route member trades to this broker.
  4. Provide broker panel login instructions securely.
  5. Monitor volume alerts; suspend if compliance issue.
3
Broker PanelSection 3 of 9

Dashboard

**Menu:** Currency Broker Panel → Main menu → Overview

Live performance — see also Dashboard help for shared metrics.

Step-by-step

  1. Review Pending count first.
  2. Check Net cash flow and inventory alerts.
  3. Jump to Trades or Inventory as needed.
4
Broker PanelSection 4 of 9

Currencies & pricing

**Menu:** Currency Broker Panel → Currencies**

Define tradable currencies and buy/sell spreads.

Page layout

  • Currency list with last update time.
  • Price form: buy rate, sell rate, min/max trade size, auto-approve threshold.

Step-by-step

  1. Open Currencies.
  2. Enable currencies your license covers.
  3. Set buy and sell rates — update when market moves.
  4. Configure min/max per trade for risk control.
  5. Save; verify member portal shows updated quotes after cache refresh.

Tips

  • Wide spread protects inventory; narrow spread drives volume.
  • Disable currency temporarily instead of deleting if trades exist.
5
Broker PanelSection 5 of 9

Inventory

**Menu:** Currency Broker Panel → Inventory**

Stock levels per currency — manual adjustments and alerts.

Step-by-step

  1. Open Inventory.
  2. Review current balances vs pending trades.
  3. Adjust after physical cash delivery or bank transfer (with note).
  4. Set low-stock alert threshold if available.
  5. Block auto-approve on pairs with insufficient inventory.
6
Broker PanelSection 6 of 9

Trades

**Menu:** Currency Broker Panel → Trades**

Operational queue — approve, settle, or reject.

Page layout

  • Filters: status, currency, channel (portal vs API), date.
  • Columns: ID, client/member, side (buy/sell), amount, rate, status, time.

Step-by-step

  1. Sort by Pending descending.
  2. Open trade — verify rate snapshot and client credit/inventory.
  3. Approve to settle or Reject with reason.
  4. For large trades, dual-control per internal policy before approve.
  5. Export daily trade log for accounting.

Status reference

StatusMeaning
**Pending**Awaiting broker action or inventory
**Approved / settled**Complete
**Rejected**Cancelled with reason
**Expired**Timed out without action
7
Broker PanelSection 7 of 9

API clients

**Menu:** Currency Broker Panel → API clients**

Manage programmatic integrators.

Step-by-step

  1. New client — name, contact, IP allowlist if used.
  2. Generate client ID and secret — share once securely.
  3. Set credit limit prepaid balance.
  4. Monitor usage in trade filter by client channel.
  5. Rotate secret periodically; revoke compromised clients immediately.
8
Broker PanelSection 8 of 9

Settings

**Menu:** Currency Broker Panel → Settings**

Business profile, notification emails, default timeouts.

Step-by-step

  1. Update contact info and settlement bank accounts.
  2. Set trade timeout minutes for pending auto-cancel.
  3. Configure email alerts for large pending queue.
9
Section 9 of 9

Summary for support

  • Broker panel is for liquidity partners — not club managers' daily tool.
  • Rate + inventory + credit jointly determine whether trades auto-settle.
  • Platform admin creates broker; broker staff run Currencies, Inventory, Trades.
Previous sectionNext section