Skip to content
Guides

Integration Options

Choose by UI delivery, caller, and authorization subject

First decide whether Whale should supply the graphical UI. Then decide whether the caller represents the Broker institution or one Client.

Comparison

Product Caller Authorization subject Form Best fit Status
WhaleAppSDK Broker App team Client iOS / Android / WebTrade graphical SDK Integrate a complete securities UI in Broker App, website, or web container Available
WhaleCore + TradingAPI Broker App Client iOS / Android / Web data SDK + HTTP API Broker App implements the complete securities UI iOS / Android / Web (WebAssembly) available
BrokerAPI Broker Server / self-built administration backend Broker HTTPS API Server-to-Server integration or a self-built administration system Available
OpenAPI A Broker’s Developers and AI apps Client Open API / SDK / MCP Algorithmic trading, quantitative analysis, and AI access to Client-authorized accounts and market data Available

Ready-made or custom UI

  • Ready-made UI: choose WhaleAppSDK. iOS and Android provide native UI; WebTrade can be deployed on a standalone domain for direct user access or embedded in a Broker’s website via iframe.
  • Implement the complete securities UI: use WhaleCore + TradingAPI. WhaleCore supplies market subscriptions, WebSocket connectivity, request signing, token renewal, and other client foundations; TradingAPI supplies account, asset, trading, and related HTTP capabilities.
flowchart TD
    A[Broker builds a Client trading experience] --> B{Use Whale's complete UI?}
    B -- Yes --> C{Target platform}
    C -- iOS --> D[WhaleAppSDK for iOS]
    C -- Android --> E[WhaleAppSDK for Android]
    C -- Web --> F[WebTrade]
    B -- No, implement all UI --> G[WhaleCore + TradingAPI]
    G --> H[iOS / Android WhaleCore]
    G --> I[Web WhaleCore WebAssembly]

Authorization boundaries

  • Broker-scoped authorization: Server-to-Server integrations and self-built administration systems use BrokerAPI; requests originate from a Broker-controlled server.
  • Client-scoped authorization: WhaleAppSDK, including WebTrade, WhaleCore, TradingAPI, and OpenAPI access private data as one Client.
  • Broker Developers vs. Developers: a Broker Developer builds the Broker product on the Broker’s behalf; a Developer is a Broker Client building on OpenAPI. The two never share credentials or authorization scope.
Note

WhaleCore has no graphical UI and does not replace TradingAPI. A Broker App implementing the complete securities UI normally combines WhaleCore connection and session foundations with TradingAPI HTTP business endpoints.

Whale Docs