@n1xyz/nord-ts 0.4.2 → 0.5.0

package/dist/actions.d.ts

@@ -53,12 +53,15 @@ export type AtomicSubaction = {
     price?: Decimal.Value;
     quoteSize?: Decimal.Value;
     clientOrderId?: BigIntValue;
+    delegatorAccountId?: number;
 } | {
     kind: "cancel";
     orderId: BigIntValue;
+    delegatorAccountId?: number;
 } | {
     kind: "cancelByClientId";
     clientOrderId: BigIntValue;
+    delegatorAccountId?: number;
 };
 export declare function atomic(client: Client<paths>, signFn: (message: Uint8Array) => Promise<Uint8Array>, currentTimestamp: bigint, nonce: number, params: {
     sessionId: BigIntValue;

package/dist/client/Nord.d.ts

@@ -3,7 +3,7 @@ import { Connection, PublicKey } from "@solana/web3.js";
 import { EventEmitter } from "events";
 import { Client } from "openapi-fetch";
 import type { paths } from "../gen/openapi.ts";
-import { Account, AccountPnlInfoPage, PagedQuery, ActionResponse, MarketsInfo, Market, MarketStats, NordConfig, OrderbookQuery, OrderbookResponse, FeeTierConfig, Token, TradesResponse, User, AccountTriggerInfo, TriggerHistoryPage, WithdrawalHistoryPage, FeeTierId, AccountFeeTierPage, PageResultStringOrderInfo, PageResultStringTrade, OrderInfoFromApi, TokenStats, FillRole, AdminInfo, AccountVolumeInfo, GetAccountVolumeQuery, CandleResolution, TakeAllInfo } from "../types";
+import { Account, AccountPnlInfoPage, AccountPositionInfoPage, AccountPnlSummaryResult, GetAccountPnlQuery, PagedQuery, ActionResponse, MarketsInfo, Market, MarketStats, NordConfig, OrderbookQuery, OrderbookResponse, FeeTierConfig, Token, TradesResponse, User, AccountTriggerInfo, TriggerPlaceHistoryPage, TriggerFinaliseHistoryPage, WithdrawalHistoryPage, FeeTierId, AccountFeeTierPage, PageResultStringOrderInfo, PageResultStringTrade, OrderInfoFromApi, TokenStats, FillRole, AdminInfo, AccountVolumeInfo, GetAccountVolumeQuery, CandleResolution, TakeAllInfo, MarketsLiveInfo, MarketLiveInfo } from "../types";
 import { NordWebSocketClient } from "../websocket/index";
 import { OrderbookSubscription, TradeSubscription, CandleSubscription } from "../websocket/Subscriber";
 /**
@@ -202,11 +202,12 @@ export declare class Nord {
      * @param pageSize - Maximum number of trades to return
      * @param since - RFC3339 timestamp to start from (inclusive)
      * @param until - RFC3339 timestamp to end at (exclusive)
-     * @param pageId - Pagination cursor returned from a prior call
+     * @param startInclusive - Pagination cursor returned from a prior call. Interpreted as a trade ID by default, or an action ID when paginationMode is "actionId".
+     * @param paginationMode - Selects whether pagination cursors are trade IDs or action IDs
      * @returns Trades response
      * @throws {NordError} If the request fails
      */
-    getTrades({ marketId, takerId, makerId, takerSide, pageSize, since, until, startInclusive, }: Readonly<{
+    getTrades({ marketId, takerId, makerId, takerSide, pageSize, since, until, startInclusive, paginationMode, }: Readonly<{
         marketId?: number;
         takerId?: number;
         makerId?: number;
@@ -215,6 +216,7 @@ export declare class Nord {
         since?: string;
         until?: string;
         startInclusive?: number;
+        paginationMode?: "tradeId" | "actionId";
     }>): Promise<TradesResponse>;
     /**
      * Get user account IDs
@@ -321,13 +323,35 @@ export declare class Nord {
      */
     getAccountPnl(accountId: number, { since, until, startInclusive, pageSize, }?: Readonly<Partial<PagedQuery>>): Promise<AccountPnlInfoPage>;
     /**
-     * Get market statistics (alias for marketsStats for backward compatibility)
+     * Get profit and loss totals for an account over a time window.
      *
+     * @param accountId - Account ID to query
+     * @param since - RFC3339 timestamp to start from (inclusive)
+     * @param until - RFC3339 timestamp to end at (inclusive)
+     * @param marketId - Optional market identifier to scope the totals
+     * @returns Per-market pnl totals for the requested window
+     * @throws {NordError} If the request fails
+     */
+    /**
+     * Fetch full history of position updates for an account.
      *
-     * @param marketId - Market identifier
-     *
-     * @returns Market statistics response
+     * @param accountId - Account ID to query
+     * @param since - RFC3339 timestamp to start from (inclusive)
+     * @param until - RFC3339 timestamp to end at (inclusive)
+     * @param marketId - Optional market identifier to scope the totals
+     * @param pageSize - Maximum number of entries to return
+     * @param startInclusive - Pagination cursor to resume from
+     * @returns History of position updates
+     * @throws {NordError} If the request fails
      */
+    getAccountPositionHistory(accountId: number, { since, until, marketId, pageSize, startInclusive, }?: Readonly<Partial<GetAccountPnlQuery & Omit<PagedQuery, "startInclusive">> & {
+        startInclusive?: string;
+    }>): Promise<AccountPositionInfoPage>;
+    getAccountPnlSummary(accountId: number, { since, until, marketId }?: Readonly<Partial<GetAccountPnlQuery>>): Promise<AccountPnlSummaryResult>;
+    getMarketsLive(): Promise<MarketsLiveInfo>;
+    getMarketLive({ marketId, }: Readonly<{
+        marketId: number;
+    }>): Promise<MarketLiveInfo>;
     getMarketStats({ marketId, }: Readonly<{
         marketId: number;
     }>): Promise<MarketStats>;
@@ -392,7 +416,20 @@ export declare class Nord {
         accountId?: number;
     }>): Promise<AccountTriggerInfo[]>;
     /**
-     * Fetch trigger history for an account.
+     * Fetch trigger placement history for an account.
+     *
+     * @param accountId - Account identifier owning the triggers
+     * @param since - RFC3339 timestamp to start from (inclusive)
+     * @param until - RFC3339 timestamp to end at (exclusive)
+     * @param pageSize - Maximum number of entries to return
+     * @param startInclusive - Pagination cursor to resume from
+     * @throws {NordError} If no account can be resolved or the request fails.
+     */
+    getAccountTriggerPlaceHistory({ accountId, since, until, pageSize, startInclusive, }: Readonly<PagedQuery & {
+        accountId?: number;
+    }>): Promise<TriggerPlaceHistoryPage>;
+    /**
+     * Fetch trigger finalisation history for an account.
      *
      * @param accountId - Account identifier owning the triggers
      * @param since - RFC3339 timestamp to start from (inclusive)
@@ -401,9 +438,9 @@ export declare class Nord {
      * @param startInclusive - Pagination cursor to resume from
      * @throws {NordError} If no account can be resolved or the request fails.
      */
-    getAccountTriggerHistory({ accountId, since, until, pageSize, startInclusive, }: Readonly<PagedQuery & {
+    getAccountTriggerFinaliseHistory({ accountId, since, until, pageSize, startInclusive, }: Readonly<PagedQuery & {
         accountId?: number;
-    }>): Promise<TriggerHistoryPage>;
+    }>): Promise<TriggerFinaliseHistoryPage>;
     /**
      * Fetch withdrawal history for an account.
      *

package/dist/client/NordUser.d.ts

@@ -28,6 +28,8 @@ export interface UserAtomicSubaction {
     quoteSize?: Decimal.Value;
     /** The client order ID of the order. */
     clientOrderId?: BigIntValue;
+    /** Optional account to delegate this subaction to. */
+    delegatorAccountId?: number;
 }
 export interface NormalizedReceiptTrade {
     orderId: bigint;
@@ -328,8 +330,8 @@ export declare class NordUser {
      * @returns Object containing the actionId of the submitted trigger
      * @throws {NordError} If the operation fails
      *
-     * Trigger identity is exact: (marketId, side, kind, triggerPrice, limits).
-     * If you add multiple triggers at the same triggerPrice, they must differ by limits.
+     * Trigger identity is a unique triggerId assigned by engine.
+     * Multiple triggers can share the same triggerPrice and limits.
      * If both `limitBaseSize` and `limitQuoteSize` are omitted, trigger executes with max reduce size
      *
      * Max triggers per position: 16
@@ -345,27 +347,41 @@ export declare class NordUser {
         accountId?: number;
     }>): Promise<{
         actionId: bigint;
+        triggerId: bigint;
     }>;
     /**
      * Remove a trigger for the current session
      *
      * @param marketId - Market the trigger belongs to
-     * @param side - Order side for the trigger
-     * @param kind - Stop-loss or take-profit trigger type
-     * @param triggerPrice - Trigger price of the trigger to remove
-     * @param limitPrice - Optional limit price of the trigger to remove
-     * @param limitBaseSize - Optional base size limit of the trigger to remove
-     * @param limitQuoteSize - Optional quote size limit of the trigger to remove
+     * @param triggerId - Unique trigger identifier to remove
      * @param accountId - Account executing the trigger
      * @returns Object containing the actionId of the removal action
      * @throws {NordError} If the operation fails
+     */
+    removeTrigger({ marketId, triggerId, accountId, }: Readonly<{
+        marketId: number;
+        triggerId: bigint;
+        accountId?: number;
+    }>): Promise<{
+        actionId: bigint;
+    }>;
+    /**
+     * Edit an existing trigger for the current session
      *
-     * Removal is exact-match by (marketId, side, kind, triggerPrice, limits).
-     * If the trigger was created with any limits, pass the same limit fields here.
-     * If trigger size limits were omitted (`NULL`) on add, keep `limitBaseSize` and `limitQuoteSize`
-     * omitted here as well.
+     * @param triggerId - Unique trigger identifier to edit
+     * @param marketId - Market to watch
+     * @param side - Order side for the trigger
+     * @param kind - Stop-loss or take-profit trigger type
+     * @param triggerPrice - Price that activates the trigger
+     * @param limitPrice - Optional limit price used once the trigger fires
+     * @param limitBaseSize - Optional base size limit used once the trigger fires
+     * @param limitQuoteSize - Optional quote size limit used once the trigger fires
+     * @param accountId - Account executing the trigger
+     * @returns Object containing the actionId of the edit action
+     * @throws {NordError} If the operation fails
      */
-    removeTrigger({ marketId, side, kind, triggerPrice, limitPrice, limitBaseSize, limitQuoteSize, accountId, }: Readonly<{
+    editTrigger({ triggerId, marketId, side, kind, triggerPrice, limitPrice, limitBaseSize, limitQuoteSize, accountId, }: Readonly<{
+        triggerId: bigint;
         marketId: number;
         side: Side;
         kind: TriggerKind;
@@ -383,14 +399,14 @@ export declare class NordUser {
      * @param tokenId - Token identifier to move
      * @param amount - Amount to transfer
      * @param fromAccountId - Source account id
-     * @param toAccountId - Destination account id
+     * @param toAccountId - Destination account id; omit to create a new owned subaccount
      * @throws {NordError} If the operation fails
      */
     transferOwned({ tokenId, amount, fromAccountId, toAccountId, }: Readonly<{
         tokenId: number;
         amount: Decimal.Value;
         fromAccountId: number;
-        toAccountId: number;
+        toAccountId?: number;
     }>): Promise<{
         actionId: bigint;
         newAccountId?: number;
@@ -473,6 +489,5 @@ export declare class NordUser {
         };
     }>;
     protected submitSignedAction(kind: proto.Action["kind"], makeSignedMessage: (message: Uint8Array) => Promise<Uint8Array>): Promise<proto.Receipt>;
-    private buildTriggerKey;
     private buildLimits;
 }