ctrader-x 0.1.0 → 0.3.0

package/README.md

@@ -1,4 +1,4 @@
-# ctrader-x
+# CTrader-x
 
 A TypeScript SDK for cTrader's Open API — connect, authenticate, stream prices, and trade, with automatic reconnection built in.
 
@@ -117,6 +117,27 @@ if (symbol) {
 
 `marketData.symbols` is a `SpotwareSymbolCatalog` — it can also be used on its own (`new SpotwareSymbolCatalog(client)`) if you only need symbol lookups.
 
+`findByName`/`getAll` return the light symbol list — enough to resolve a name to a `symbolId` and subscribe. For the trading constraints that list doesn't carry (`lotSize`, `minVolume`/`maxVolume`/`stepVolume`, `digits`, `pipPosition`), fetch the full spec:
+
+```typescript
+const fullSymbol = await marketData.symbols.getFullSymbol(symbol.symbolId);
+```
+
+See [A note on volume](#a-note-on-volume) under Trading for why these matter before placing an order.
+
+Historical bars are a one-off fetch, not a subscription:
+
+```typescript
+import { ProtoOATrendbarPeriod } from 'ctrader-x';
+
+const bars = await marketData.getTrendbars({
+    symbolId: symbol.symbolId,
+    period: ProtoOATrendbarPeriod.H1,
+    fromTimestamp: Date.now() - 7 * 24 * 60 * 60 * 1000, // last 7 days
+    toTimestamp: Date.now()
+});
+```
+
 ### Trading
 
 ```typescript
@@ -137,15 +158,294 @@ const { positions, orders } = await trading.getOpenPositionsAndOrders();
 
 `volume` here is in **units** of the symbol's base currency (for EURUSD, 1 unit = 1 EUR), not lots. On the wire, cTrader represents volume as "cents of a unit" — `100000` means `1000.00` units — and `trading` converts to and from that form for you, so you always work in whole units through this API, never the wire's scaled integer.
 
-Units and lots are not the same thing, and the conversion between them is **not a fixed ratio you can hardcode**. How many units make up "1 lot" is defined per symbol, not by the protocol — retail forex conventionally uses 100,000 units per lot, but that's a market convention, not something cTrader's API guarantees for every symbol (it can differ for indices, commodities, crypto, or simply per broker). The authoritative values — `lotSize`, plus the tradable `minVolume`/`maxVolume`/`stepVolume` range — live on the full symbol spec (`ProtoOASymbol`, fetched via `PROTO_OA_SYMBOL_BY_ID_REQ`), not on the lighter `ProtoOALightSymbol` that `SpotwareSymbolCatalog` currently exposes. If your UI works in lots, fetch that full spec yourself and convert before calling `trading`; `ctrader-x` doesn't wrap that request yet.
+Units and lots are not the same thing, and the conversion between them is **not a fixed ratio you can hardcode**. How many units make up "1 lot" is defined per symbol, not by the protocol — retail forex conventionally uses 100,000 units per lot, but that's a market convention, not something cTrader's API guarantees for every symbol (it can differ for indices, commodities, crypto, or simply per broker). The authoritative values — `lotSize`, plus the tradable `minVolume`/`maxVolume`/`stepVolume` range — live on the full symbol spec, not the lighter one `getAll()`/`findByName()` return:
+
+```typescript
+const fullSymbol = await marketData.symbols.getFullSymbol(symbol.symbolId);
+```
+
+If your UI works in lots, or you want to validate a volume before sending it, fetch that spec and convert or check against it before calling `trading`. `ctrader-x` gives you the raw values; it doesn't do that conversion or validation for you.
 
 More complete, runnable examples live in [`src/example/`](src/example/):
 
 ```bash
 npm run start:market-data   # subscribe to a symbol and print live prices
 npm run start:trading       # query positions/orders, place and cancel a safe limit order
+npm run start:trendbars     # fetch the last 24h of H1 bars for a symbol
+```
+
+## API Reference
+
+Everything below is exported from the package root (`import { ... } from 'ctrader-x'`). Classes with events expose `once()` and `off()` with the same signatures as `on()`. The generated Protobuf message and enum types (`ProtoOA...`, `Proto...` — roughly 300 of them) aren't listed individually; see [Types](#types) at the end.
+
+### Transport
+
+#### `SpotwareTransport`
+
+Opens the TCP/TLS connection, frames Protobuf messages on the wire, and auto-reconnects with backoff on any drop that wasn't requested via `disconnect()`.
+
+```typescript
+class SpotwareTransport {
+    constructor(options: ISpotwareTransportOptions);
+
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(message: ProtoMessage): Promise<void>;
+
+    on(event: 'connected', listener: () => void): this;
+    on(event: 'disconnected', listener: (reason: SpotwareDisconnectReason) => void): this;
+    on(event: 'reconnecting', listener: (attempt: number, delayMs: number) => void): this;
+    on(event: 'message', listener: (message: ProtoMessage) => void): this;
+    on(event: 'error', listener: (error: Error) => void): this;
+}
+
+interface ISpotwareTransportOptions {
+    host: SpotwareHost;
+    port?: number;                                 // default: SPOTWARE_PORT (5035)
+    reconnectBackoff?: IReconnectBackoffOptions;    // default: DEFAULT_RECONNECT_BACKOFF_OPTIONS
+    socketFactory?: SpotwareSocketFactory;          // default: real tls.connect; override for testing
+    staleConnectionTimeoutMs?: number;              // default: 30000
+}
+```
+
+- `connect()` rejects if the very first attempt fails — likely a config problem worth surfacing, not something to retry silently. A later reconnect attempt that fails keeps retrying with backoff instead of stopping, since by then the target is already known to be reachable.
+- `disconnect()` is an intentional disconnect: no auto-reconnect follows it.
+- A liveness watchdog force-reconnects if no data has been received for `staleConnectionTimeoutMs`. A silent network outage produces no socket-level `error`/`close` on its own — TCP only notices once something tries to use the connection, which can take far longer than that timeout.
+
+```typescript
+enum SpotwareHost {
+    DEMO = 'demo.ctraderapi.com',
+    LIVE = 'live.ctraderapi.com'
+}
 ```
 
+| Other export | Description |
+| --- | --- |
+| `SPOTWARE_PORT` | `5035` — cTrader's Open API TCP port. |
+| `IReconnectBackoffOptions` | `{ baseDelayMs, maxDelayMs, factor }` |
+| `DEFAULT_RECONNECT_BACKOFF_OPTIONS` | `{ baseDelayMs: 500, maxDelayMs: 30_000, factor: 2 }` |
+| `calculateReconnectDelayMs(attempt, options?)` | Pure function computing the next backoff delay, with jitter. |
+| `SpotwareSocketFactory` | `(port, host) => Promise<Duplex>` — inject a test double instead of a real socket. |
+| `SpotwareDisconnectReason` | `'manual' \| 'dropped'` |
+
+### Auth
+
+#### `SpotwareOAuthClient`
+
+The HTTP half of the OAuth2 flow: authorize URL, code exchange, refresh. Knows nothing about the socket.
+
+```typescript
+class SpotwareOAuthClient {
+    constructor(options: { clientId: string; clientSecret: string });
+
+    buildAuthorizationUrl(params: { redirectUri: string; scope: SpotwareOAuthScope }): string;
+    exchangeAuthorizationCode(params: { code: string; redirectUri: string }): Promise<ISpotwareOAuthToken>;
+    refreshAccessToken(params: { refreshToken: string }): Promise<ISpotwareOAuthToken>;
+}
+```
+
+Throws `SpotwareOAuthError` (`errorCode?: string`, `httpStatus?: number`) on failure. Refresh tokens are single-use — always persist the token returned from a refresh call, not just the original one.
+
+#### `SpotwareSocketAuthenticator`
+
+The socket half of authentication: `ApplicationAuthReq` → `GetAccountListByAccessTokenReq` → `AccountAuthReq`. Requires an already-connected `SpotwareTransport`.
+
+```typescript
+class SpotwareSocketAuthenticator {
+    constructor(transport: SpotwareTransport, options?: { responseTimeoutMs?: number }); // default: 10000
+
+    authenticateApplication(clientId: string, clientSecret: string): Promise<void>;
+    listAccounts(accessToken: string): Promise<ProtoOACtidTraderAccount[]>;
+    authenticateAccount(ctidTraderAccountId: number, accessToken: string): Promise<void>;
+}
+```
+
+Throws `SpotwareSocketAuthError` (`errorCode?: string`) on failure. Most consumers won't call this directly — `SpotwareClient` runs this handshake automatically, including after every reconnect. It's exposed for the one-time account discovery step; see [Authenticating for the first time](#authenticating-for-the-first-time).
+
+| Other export | Description |
+| --- | --- |
+| `SpotwareOAuthScope` | `enum { ACCOUNTS = 'accounts', TRADING = 'trading' }` |
+| `ISpotwareOAuthToken` | `{ accessToken, refreshToken, tokenType, expiresIn }` |
+| `SpotwareOAuthError` | `Error` subclass — `errorCode?`, `httpStatus?` |
+| `SpotwareSocketAuthError` | `Error` subclass — `errorCode?` |
+
+### Client
+
+#### `SpotwareClient`
+
+Request/response correlation on top of `transport` + `auth`: tags each request with a `clientMsgId` and resolves once the matching response arrives. Re-runs the auth handshake on every `transport` `'connected'` event, including reconnects, and refreshes the token when it's close to expiry.
+
+```typescript
+class SpotwareClient {
+    constructor(options: ISpotwareClientOptions);
+
+    readonly ctidTraderAccountId: number;
+
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(payloadType: number, payload: Uint8Array): Promise<ProtoMessage>;
+
+    on(event: 'authenticated', listener: () => void): this;
+    on(event: 'tokenRefreshed', listener: (token: ISpotwareOAuthToken) => void): this;
+    on(event: 'message', listener: (message: ProtoMessage) => void): this;
+    on(event: 'error', listener: (error: Error) => void): this;
+}
+
+interface ISpotwareClientOptions {
+    transport: SpotwareTransport;
+    oauthClient: SpotwareOAuthClient;
+    clientId: string;
+    clientSecret: string;
+    ctidTraderAccountId: number;
+    token: ISpotwareOAuthToken;
+    requestTimeoutMs?: number;       // default: 10000
+    tokenRefreshBufferMs?: number;   // default: 300000 (refresh 5 minutes before expiry)
+}
+```
+
+- `send()` rejects with `SpotwareRequestError` on a correlated error response, on timeout, or immediately if the connection drops while the request is in flight — it doesn't wait out its own timeout once `transport` already knows the connection is gone.
+- The `'message'` event fires for every message received, including ones with no matching pending request (e.g. spot price events). `market-data` and `trading` are built on this.
+- Always attach an `'error'` listener — per Node's `EventEmitter` convention, an unlistened `'error'` event throws and crashes the process. `SpotwareClient` forwards `transport`'s errors here too, so this one listener covers both.
+
+| Other export | Description |
+| --- | --- |
+| `SpotwareRequestError` | `Error` subclass — `errorCode?: string` |
+
+### Market data
+
+#### `SpotwareMarketData`
+
+```typescript
+class SpotwareMarketData {
+    constructor(client: SpotwareClient, symbolCatalog?: SpotwareSymbolCatalog);
+
+    readonly symbols: SpotwareSymbolCatalog;
+
+    subscribe(symbol: number | string): Promise<void>;   // a symbolId, or a name resolved via `symbols`
+    unsubscribe(symbol: number | string): Promise<void>;
+    getTrendbars(params: IGetTrendbarsParams): Promise<ITrendbar[]>;   // a one-off fetch, not a subscription
+
+    on(event: 'price', listener: (update: ISpotwarePriceUpdate) => void): this;
+    on(event: 'error', listener: (error: Error) => void): this;
+}
+
+interface ISpotwarePriceUpdate {
+    symbolId: number;
+    bid?: number;       // already converted from the wire's fixed-point form
+    ask?: number;
+    timestamp?: number;
+}
+
+interface IGetTrendbarsParams {
+    symbolId: number;
+    period: ProtoOATrendbarPeriod;
+    fromTimestamp?: number;   // Unix ms, must be >= 0
+    toTimestamp?: number;     // Unix ms, must be <= 2147483646000 (2038-01-19)
+    count?: number;           // caps the number of bars, counting back from toTimestamp
+}
+
+interface ITrendbar {
+    period: ProtoOATrendbarPeriod;
+    timestamp?: number;   // Unix ms, converted from the wire's utcTimestampInMinutes
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+```
+
+Re-subscribes to everything currently subscribed whenever `client` re-authenticates (including after a reconnect) — a fresh connection has no memory of prior subscriptions, so without this a reconnect would silently go quiet on price data.
+
+`getTrendbars` fetches historical bars once; it doesn't subscribe to anything ongoing. Bar prices (`open`/`high`/`low`/`close`) are converted for you the same way spot prices are — confirmed against cTrader's own documentation, since the field comments in the underlying Protobuf message don't state the scale themselves.
+
+#### `SpotwareSymbolCatalog`
+
+Public on its own (`new SpotwareSymbolCatalog(client)`), and used internally by `SpotwareMarketData` — `marketData.symbols` is one of these.
+
+```typescript
+class SpotwareSymbolCatalog {
+    constructor(client: SpotwareClient);
+
+    getAll(): Promise<ProtoOALightSymbol[]>;
+    findByName(symbolName: string): Promise<ProtoOALightSymbol | undefined>;   // case-insensitive
+    findById(symbolId: number): Promise<ProtoOALightSymbol | undefined>;
+    refresh(): Promise<ProtoOALightSymbol[]>;                                  // forces a re-fetch
+
+    getFullSymbol(symbolId: number): Promise<ProtoOASymbol | undefined>;      // lotSize, min/max/stepVolume, digits, pipPosition
+}
+```
+
+`getAll`/`findByName`/`findById` share one cached fetch; `getFullSymbol` caches per `symbolId`. Neither caches a failure — the next call retries instead of returning a permanently broken promise.
+
+### Trading
+
+#### `SpotwareTrading`
+
+Places/modifies/cancels orders and closes positions, via `client`. Knows nothing about market data streaming.
+
+```typescript
+class SpotwareTrading {
+    constructor(client: SpotwareClient);
+
+    placeMarketOrder(params: IPlaceMarketOrderParams): Promise<ProtoOAExecutionEvent>;
+    placeLimitOrder(params: IPlaceLimitOrderParams): Promise<ProtoOAExecutionEvent>;
+    amendOrder(params: IAmendOrderParams): Promise<ProtoOAExecutionEvent>;
+    cancelOrder(orderId: number): Promise<ProtoOAExecutionEvent>;
+    closePosition(params: IClosePositionParams): Promise<ProtoOAExecutionEvent>;
+    getOpenPositionsAndOrders(): Promise<IOpenPositionsAndOrders>;
+}
+
+interface IPlaceMarketOrderParams {
+    symbolId: number;
+    tradeSide: ProtoOATradeSide;
+    volume: number;          // in units — see "A note on volume" above
+    stopLoss?: number;       // absolute price, not scaled
+    takeProfit?: number;     // absolute price, not scaled
+    comment?: string;
+    label?: string;
+}
+
+interface IPlaceLimitOrderParams extends IPlaceMarketOrderParams {
+    limitPrice: number;      // absolute price, not scaled
+    timeInForce?: ProtoOATimeInForce;
+    expirationTimestamp?: number;
+}
+
+interface IAmendOrderParams {
+    orderId: number;
+    volume?: number;         // in units
+    limitPrice?: number;
+    stopPrice?: number;
+    stopLoss?: number;
+    takeProfit?: number;
+    expirationTimestamp?: number;
+}
+
+interface IClosePositionParams {
+    positionId: number;
+    volume: number;          // in units
+}
+
+interface IOpenPositionsAndOrders {
+    positions: ProtoOAPosition[];
+    orders: ProtoOAOrder[];
+}
+```
+
+Order mutations have no dedicated response message — the outcome arrives as a `ProtoOAExecutionEvent` on success, and `send()` rejects with `SpotwareRequestError` on failure. Both are already handled for you; these methods just resolve or reject.
+
+### Shared
+
+| Export | Description |
+| --- | --- |
+| `SPOTWARE_PRICE_SCALE` | `100_000` — the fixed-point scale for bid/ask and relative SL/TP. Not every price field uses it; see [A note on volume](#a-note-on-volume). |
+| `SPOTWARE_VOLUME_SCALE` | `100` — the fixed-point scale for volume ("cents of a unit"). |
+
+### Types
+
+Every Protobuf message and enum from Spotware's Open API — `ProtoOANewOrderReq`, `ProtoOATradeSide`, `ProtoOAExecutionEvent`, and roughly 300 more — is generated directly from the official `.proto` files (see [Regenerating protocol types](#regenerating-protocol-types)) and exported from the package root. They aren't listed individually here; each one carries its own field-level doc comments, visible in your editor.
+
 ## Development
 
 ### Running tests

package/dist/example/market-data-example.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const market_data_1 = require("../market-data");
+const spotware_scale_1 = require("../shared/spotware-scale");
 const create_authenticated_client_1 = require("./shared/create-authenticated-client");
 const SYMBOL_NAME = process.argv[2] ?? 'EURUSD';
 const LISTEN_DURATION_MS = 60_000;
@@ -17,6 +18,21 @@ async function main() {
     if (!symbol) {
         throw new Error(`Symbol "${SYMBOL_NAME}" was not found for this account`);
     }
+    // getFullSymbol() is the full per-symbol spec — findByName()/getAll() only return the
+    // light list, which doesn't carry the fields you need to validate a volume or round a
+    // price correctly, since those are defined per symbol by the broker, not a fixed ratio.
+    const fullSymbol = await marketData.symbols.getFullSymbol(symbol.symbolId);
+    if (fullSymbol) {
+        console.log(`\n${symbol.symbolName} trading constraints:`);
+        console.table({
+            digits: fullSymbol.digits,
+            pipPosition: fullSymbol.pipPosition,
+            lotSizeUnits: (fullSymbol.lotSize ?? 0) / spotware_scale_1.SPOTWARE_VOLUME_SCALE,
+            minVolumeUnits: (fullSymbol.minVolume ?? 0) / spotware_scale_1.SPOTWARE_VOLUME_SCALE,
+            maxVolumeUnits: (fullSymbol.maxVolume ?? 0) / spotware_scale_1.SPOTWARE_VOLUME_SCALE,
+            stepVolumeUnits: (fullSymbol.stepVolume ?? 0) / spotware_scale_1.SPOTWARE_VOLUME_SCALE
+        });
+    }
     console.log(`\nSubscribing to ${symbol.symbolName} (symbolId ${symbol.symbolId})...`);
     await marketData.subscribe(symbol.symbolId);
     console.log(`Listening for price updates for ${LISTEN_DURATION_MS / 1000}s (Ctrl+C to stop earlier)...\n`);

package/dist/example/market-data-example.js.map

@@ -1 +1 @@
-{"version":3,"file":"market-data-example.js","sourceRoot":"","sources":["../../src/example/market-data-example.ts"],"names":[],"mappings":";;AAAA,gDAAoD;AACpD,sFAAiF;AAEjF,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;AAChD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,KAAK,UAAU,IAAI;IACf,MAAM,MAAM,GAAG,MAAM,IAAA,uDAAyB,GAAE,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,gCAAkB,CAAC,MAAM,CAAC,CAAC;IAClD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACtF,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,SAAS,GAAG,QAAQ,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,kCAAkC,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,UAAU,cAAc,MAAM,CAAC,QAAQ,MAAM,CAAC,CAAC;IACtF,MAAM,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE5C,OAAO,CAAC,GAAG,CAAC,mCAAmC,kBAAkB,GAAG,IAAI,iCAAiC,CAAC,CAAC;IAC3G,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAExE,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,MAAM,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;AAC9B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE;IAC1B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"market-data-example.js","sourceRoot":"","sources":["../../src/example/market-data-example.ts"],"names":[],"mappings":"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"}

package/dist/example/trendbars-example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trendbars-example.d.ts.map

package/dist/example/trendbars-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trendbars-example.d.ts","sourceRoot":"","sources":["../../src/example/trendbars-example.ts"],"names":[],"mappings":""}

package/dist/example/trendbars-example.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const market_data_1 = require("../market-data");
+const types_1 = require("../types");
+const create_authenticated_client_1 = require("./shared/create-authenticated-client");
+async function main() {
+    const client = await (0, create_authenticated_client_1.createAuthenticatedClient)();
+    const marketData = new market_data_1.SpotwareMarketData(client);
+    const symbolName = process.argv[2] ?? 'EURUSD';
+    const symbol = await marketData.symbols.findByName(symbolName);
+    if (!symbol) {
+        throw new Error(`Symbol "${symbolName}" was not found for this account`);
+    }
+    const bars = await marketData.getTrendbars({
+        symbolId: symbol.symbolId,
+        period: types_1.ProtoOATrendbarPeriod.H1,
+        fromTimestamp: Date.now() - 24 * 60 * 60 * 1000,
+        toTimestamp: Date.now()
+    });
+    console.log(`\nFetched ${bars.length} H1 bars for ${symbol.symbolName}:`);
+    console.table(bars.map((bar) => ({ ...bar, timestamp: bar.timestamp ? new Date(bar.timestamp).toISOString() : undefined })));
+    await client.disconnect();
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=trendbars-example.js.map

package/dist/example/trendbars-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trendbars-example.js","sourceRoot":"","sources":["../../src/example/trendbars-example.ts"],"names":[],"mappings":";;AAAA,gDAAoD;AACpD,oCAAiD;AACjD,sFAAiF;AAEjF,KAAK,UAAU,IAAI;IACf,MAAM,MAAM,GAAG,MAAM,IAAA,uDAAyB,GAAE,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,gCAAkB,CAAC,MAAM,CAAC,CAAC;IAElD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,WAAW,UAAU,kCAAkC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC;QACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,6BAAqB,CAAC,EAAE;QAChC,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QAC/C,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;KAC1B,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,MAAM,gBAAgB,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;IAC1E,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IAE7H,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;AAC9B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE;IAC1B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './auth';
 export * from './client';
 export * from './market-data';
+export * from './shared';
 export * from './trading';
 export * from './transport';
 export * from './types';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./auth"), exports);
 __exportStar(require("./client"), exports);
 __exportStar(require("./market-data"), exports);
+__exportStar(require("./shared"), exports);
 __exportStar(require("./trading"), exports);
 __exportStar(require("./transport"), exports);
 __exportStar(require("./types"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,2CAAyB;AACzB,gDAA8B;AAC9B,4CAA0B;AAC1B,8CAA4B;AAC5B,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,2CAAyB;AACzB,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAC1B,8CAA4B;AAC5B,0CAAwB"}

package/dist/market-data/spotware-market-data.d.ts

@@ -1,5 +1,6 @@
 import type { SpotwareClient } from '../client';
 import { TypedEventEmitter, type EventMap } from '../shared/typed-event-emitter';
+import { ProtoOATrendbarPeriod } from '../types';
 import { SpotwareSymbolCatalog } from './spotware-symbol-catalog';
 export interface ISpotwarePriceUpdate {
     symbolId: number;
@@ -11,6 +12,26 @@ export interface ISpotwareMarketDataEvents extends EventMap {
     price: [update: ISpotwarePriceUpdate];
     error: [error: Error];
 }
+export interface IGetTrendbarsParams {
+    symbolId: number;
+    period: ProtoOATrendbarPeriod;
+    /** Unix time in milliseconds. Must be >= 0. */
+    fromTimestamp?: number;
+    /** Unix time in milliseconds. Must be <= 2147483646000 (2038-01-19). */
+    toTimestamp?: number;
+    /** Caps the number of bars returned, counting back from toTimestamp. */
+    count?: number;
+}
+export interface ITrendbar {
+    period: ProtoOATrendbarPeriod;
+    /** Unix time in milliseconds, converted from the wire's utcTimestampInMinutes. */
+    timestamp?: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
 /**
  * Subscribes to spot prices via `client` and exposes them as a clean 'price' event, decimal
  * bid/ask already converted. Re-subscribes to everything currently subscribed whenever
@@ -24,6 +45,8 @@ export declare class SpotwareMarketData extends TypedEventEmitter<ISpotwareMarke
     constructor(client: SpotwareClient, symbolCatalog?: SpotwareSymbolCatalog);
     subscribe(symbol: number | string): Promise<void>;
     unsubscribe(symbol: number | string): Promise<void>;
+    /** Fetches historical bars — a one-off request, not a subscription. */
+    getTrendbars(params: IGetTrendbarsParams): Promise<ITrendbar[]>;
     private resolveSymbolId;
     private handleMessage;
     private resubscribeAll;

package/dist/market-data/spotware-market-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spotware-market-data.d.ts","sourceRoot":"","sources":["../../src/market-data/spotware-market-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAA0B,SAAQ,QAAQ;IACvD,KAAK,EAAE,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACzB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB,CAAC,yBAAyB,CAAC;IAChF,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IAExC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;gBAE7C,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,EAAE,qBAAqB;IASnE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAa3C,eAAe;IAa7B,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,cAAc;CAgBzB"}
+{"version":3,"file":"spotware-market-data.d.ts","sourceRoot":"","sources":["../../src/market-data/spotware-market-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAQH,qBAAqB,EAExB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAA0B,SAAQ,QAAQ;IACvD,KAAK,EAAE,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB,CAAC,yBAAyB,CAAC;IAChF,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IAExC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;gBAE7C,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,EAAE,qBAAqB;IASnE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD,uEAAuE;IACjE,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YAevD,eAAe;IAa7B,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,cAAc;CAgBzB"}

package/dist/market-data/spotware-market-data.js

@@ -32,6 +32,19 @@ class SpotwareMarketData extends typed_event_emitter_1.TypedEventEmitter {
         await this.client.send(types_1.ProtoOAPayloadType.PROTO_OA_UNSUBSCRIBE_SPOTS_REQ, types_1.ProtoOAUnsubscribeSpotsReq.encode(types_1.ProtoOAUnsubscribeSpotsReq.fromPartial({ ctidTraderAccountId: this.client.ctidTraderAccountId, symbolId: [symbolId] })).finish());
         this.subscribedSymbolIds.delete(symbolId);
     }
+    /** Fetches historical bars — a one-off request, not a subscription. */
+    async getTrendbars(params) {
+        const request = types_1.ProtoOAGetTrendbarsReq.fromPartial({
+            ctidTraderAccountId: this.client.ctidTraderAccountId,
+            symbolId: params.symbolId,
+            period: params.period,
+            fromTimestamp: params.fromTimestamp,
+            toTimestamp: params.toTimestamp,
+            count: params.count
+        });
+        const response = await this.client.send(types_1.ProtoOAPayloadType.PROTO_OA_GET_TRENDBARS_REQ, encodeGetTrendbarsReq(request));
+        return types_1.ProtoOAGetTrendbarsRes.decode(response.payload ?? new Uint8Array()).trendbar.map(toCleanTrendbar);
+    }
     async resolveSymbolId(symbol) {
         if (typeof symbol === 'number') {
             return symbol;
@@ -65,4 +78,31 @@ class SpotwareMarketData extends typed_event_emitter_1.TypedEventEmitter {
     }
 }
 exports.SpotwareMarketData = SpotwareMarketData;
+// ts-proto skips a required field on the wire whenever its value equals the field's implicit
+// proto2 default — for an enum with no explicit `[default = ...]` annotation, that's always its
+// first declared member. `period` has no such annotation, so M1 (1) — the single most common
+// period to request — gets silently dropped, the same class of bug fixed for orderType/tradeSide
+// in the trading module. Field order doesn't matter on the wire, so appending it after the
+// normal encode is a safe, minimal fix that doesn't require hand-editing generated code.
+function encodeGetTrendbarsReq(request) {
+    const writer = types_1.ProtoOAGetTrendbarsReq.encode(request);
+    if (request.period === types_1.ProtoOATrendbarPeriod.M1) {
+        writer.uint32(40).int32(request.period);
+    }
+    return writer.finish();
+}
+// Bar prices are delta-encoded off `low` and fixed-point scaled, confirmed against cTrader's
+// own help center docs (not assumed): open = (low + deltaOpen) / scale, etc.
+function toCleanTrendbar(trendbar) {
+    const low = trendbar.low ?? 0;
+    return {
+        period: trendbar.period ?? types_1.ProtoOATrendbarPeriod.M1,
+        timestamp: trendbar.utcTimestampInMinutes === undefined ? undefined : trendbar.utcTimestampInMinutes * 60_000,
+        low: low / spotware_scale_1.SPOTWARE_PRICE_SCALE,
+        open: (low + (trendbar.deltaOpen ?? 0)) / spotware_scale_1.SPOTWARE_PRICE_SCALE,
+        high: (low + (trendbar.deltaHigh ?? 0)) / spotware_scale_1.SPOTWARE_PRICE_SCALE,
+        close: (low + (trendbar.deltaClose ?? 0)) / spotware_scale_1.SPOTWARE_PRICE_SCALE,
+        volume: trendbar.volume
+    };
+}
 //# sourceMappingURL=spotware-market-data.js.map

package/dist/market-data/spotware-market-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"spotware-market-data.js","sourceRoot":"","sources":["../../src/market-data/spotware-market-data.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"spotware-market-data.js","sourceRoot":"","sources":["../../src/market-data/spotware-market-data.ts"],"names":[],"mappings":"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"}

package/dist/market-data/spotware-symbol-catalog.d.ts

@@ -1,5 +1,5 @@
 import type { SpotwareClient } from '../client';
-import { ProtoOALightSymbol } from '../types';
+import { ProtoOALightSymbol, ProtoOASymbol } from '../types';
 /**
  * Fetches and caches the account's symbol list, and resolves a ticker name (e.g. "EURUSD")
  * to the numeric symbolId every other request actually needs. Public on its own — trading
@@ -9,11 +9,20 @@ import { ProtoOALightSymbol } from '../types';
 export declare class SpotwareSymbolCatalog {
     private readonly client;
     private symbolsPromise;
+    private readonly fullSymbolPromises;
     constructor(client: SpotwareClient);
     getAll(): Promise<ProtoOALightSymbol[]>;
     findByName(symbolName: string): Promise<ProtoOALightSymbol | undefined>;
     findById(symbolId: number): Promise<ProtoOALightSymbol | undefined>;
     refresh(): Promise<ProtoOALightSymbol[]>;
+    /**
+     * Fetches the full symbol spec — lotSize, minVolume/maxVolume/stepVolume, digits,
+     * pipPosition, and everything else `getAll()`'s light list doesn't carry. Needed to
+     * validate a volume or round a price correctly before placing an order: those constraints
+     * are defined per symbol by the broker, not by a fixed, hardcodable ratio.
+     */
+    getFullSymbol(symbolId: number): Promise<ProtoOASymbol | undefined>;
     private fetchSymbols;
+    private fetchFullSymbol;
 }
 //# sourceMappingURL=spotware-symbol-catalog.d.ts.map

package/dist/market-data/spotware-symbol-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spotware-symbol-catalog.d.ts","sourceRoot":"","sources":["../../src/market-data/spotware-symbol-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAoE,MAAM,UAAU,CAAC;AAEhH;;;;;GAKG;AACH,qBAAa,qBAAqB;IAGlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,cAAc,CAA4C;gBAErC,MAAM,EAAE,cAAc;IAE7C,MAAM,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQvC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAOvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAOzE,OAAO,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAM1B,YAAY;CAgB7B"}
+{"version":3,"file":"spotware-symbol-catalog.d.ts","sourceRoot":"","sources":["../../src/market-data/spotware-symbol-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EACH,kBAAkB,EAElB,aAAa,EAKhB,MAAM,UAAU,CAAC;AAElB;;;;;GAKG;AACH,qBAAa,qBAAqB;IAIlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,cAAc,CAA4C;IAClE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyD;gBAE/D,MAAM,EAAE,cAAc;IAE7C,MAAM,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQvC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAOvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAOzE,OAAO,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAMxC;;;;;OAKG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;YAU3D,YAAY;YAiBZ,eAAe;CAWhC"}

package/dist/market-data/spotware-symbol-catalog.js

@@ -11,6 +11,7 @@ const types_1 = require("../types");
 class SpotwareSymbolCatalog {
     client;
     symbolsPromise;
+    fullSymbolPromises = new Map();
     constructor(client) {
         this.client = client;
     }
@@ -34,6 +35,20 @@ class SpotwareSymbolCatalog {
         this.symbolsPromise = this.fetchSymbols();
         return this.symbolsPromise;
     }
+    /**
+     * Fetches the full symbol spec — lotSize, minVolume/maxVolume/stepVolume, digits,
+     * pipPosition, and everything else `getAll()`'s light list doesn't carry. Needed to
+     * validate a volume or round a price correctly before placing an order: those constraints
+     * are defined per symbol by the broker, not by a fixed, hardcodable ratio.
+     */
+    async getFullSymbol(symbolId) {
+        let promise = this.fullSymbolPromises.get(symbolId);
+        if (!promise) {
+            promise = this.fetchFullSymbol(symbolId);
+            this.fullSymbolPromises.set(symbolId, promise);
+        }
+        return promise;
+    }
     async fetchSymbols() {
         try {
             const request = types_1.ProtoOASymbolsListReq.fromPartial({ ctidTraderAccountId: this.client.ctidTraderAccountId });
@@ -47,6 +62,17 @@ class SpotwareSymbolCatalog {
             throw error;
         }
     }
+    async fetchFullSymbol(symbolId) {
+        try {
+            const request = types_1.ProtoOASymbolByIdReq.fromPartial({ ctidTraderAccountId: this.client.ctidTraderAccountId, symbolId: [symbolId] });
+            const response = await this.client.send(types_1.ProtoOAPayloadType.PROTO_OA_SYMBOL_BY_ID_REQ, types_1.ProtoOASymbolByIdReq.encode(request).finish());
+            return types_1.ProtoOASymbolByIdRes.decode(response.payload ?? new Uint8Array()).symbol.find((symbol) => symbol.symbolId === symbolId);
+        }
+        catch (error) {
+            this.fullSymbolPromises.delete(symbolId);
+            throw error;
+        }
+    }
 }
 exports.SpotwareSymbolCatalog = SpotwareSymbolCatalog;
 //# sourceMappingURL=spotware-symbol-catalog.js.map

package/dist/market-data/spotware-symbol-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"spotware-symbol-catalog.js","sourceRoot":"","sources":["../../src/market-data/spotware-symbol-catalog.ts"],"names":[],"mappings":";;;AACA,oCAAgH;AAEhH;;;;;GAKG;AACH,MAAa,qBAAqB;IAGD;IAFrB,cAAc,CAA4C;IAElE,YAA6B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAEvD,KAAK,CAAC,MAAM;QACR,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACvB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAC9C,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAkB;QAC/B,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAEpC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAEpC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED,iFAAiF;IACjF,OAAO;QACH,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1C,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,YAAY;QACtB,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,6BAAqB,CAAC,WAAW,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;YAC5G,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACnC,0BAAkB,CAAC,yBAAyB,EAC5C,6BAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CACjD,CAAC;YAEF,OAAO,6BAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACrF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,4EAA4E;YAC5E,uCAAuC;YACvC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;YAChC,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;CACJ;AAjDD,sDAiDC"}
+{"version":3,"file":"spotware-symbol-catalog.js","sourceRoot":"","sources":["../../src/market-data/spotware-symbol-catalog.ts"],"names":[],"mappings":"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"}

package/dist/shared/index.d.ts

@@ -0,0 +1,2 @@
+export * from './spotware-scale';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./spotware-scale"), exports);
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ctrader-x",
-    "version": "0.1.0",
+    "version": "0.3.0",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "files": [
@@ -25,6 +25,7 @@
         "start": "ts-node src/example/example.ts",
         "start:market-data": "ts-node src/example/market-data-example.ts",
         "start:trading": "ts-node src/example/trading-example.ts",
+        "start:trendbars": "ts-node src/example/trendbars-example.ts",
         "test": "vitest run",
         "test:watch": "vitest",
         "generate:types": "grpc_tools_node_protoc --plugin=protoc-gen-ts_proto=./node_modules/.bin/protoc-gen-ts_proto --ts_proto_out=./src/types/generated --ts_proto_opt=esModuleInterop=true,outputServices=none,useOptionals=messages,unrecognizedEnum=false -I proto proto/OpenApiCommonModelMessages.proto proto/OpenApiCommonMessages.proto proto/OpenApiModelMessages.proto proto/OpenApiMessages.proto"