@lifi/perps-sdk 0.1.1-alpha.9 → 1.0.0

package/dist/esm/services/getAccount.d.ts

@@ -1,32 +1,35 @@
-import type { AccountResponse, Address } from '@lifi/perps-types';
-import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+import type { AccountResponse } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getAccount}.
+ *
+ * @public
+ */
 export interface GetAccountParams {
-    /** DEX to get account from (e.g., 'hyperliquid') */
-    dex: string;
-    /** Wallet address */
+    provider: string;
     address: Address;
 }
 /**
- * Get account information including balances, positions, and open orders.
+ * Get account information (balances, margin, fee tier, typed config).
+ * Delegates to the registered venue plugin (direct-to-venue); requires the
+ * provider plugin to be registered on the client.
  *
- * @param client - The SDK client instance
- * @param params - Request parameters
- * @param options - Request options (e.g., AbortSignal)
- * @returns Account details
- * @throws {HTTPError} On API error responses
- * @throws {PerpsError} On network or parsing errors
+ * Use {@link getPositions} and {@link getOrders} to fetch positions and orders
+ * separately.
  *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
  * @example
  * ```ts
- * const client = createPerpsClient({ integrator: 'my-app' })
  * const account = await getAccount(client, {
- *   dex: 'hyperliquid',
- *   address: '0x1234...'
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
  * })
- * console.log(account.balances) // [{ currency: 'USDC', amount: '10000.00' }]
- * console.log(account.positions) // [{ symbol: 'BTC', side: 'LONG', ... }]
- * console.log(account.openOrders) // [{ id: '123', symbol: 'BTC', ... }]
+ * console.log(account.balances)
  * ```
+ * @public
  */
 export declare function getAccount(client: PerpsSDKClient, params: GetAccountParams, options?: SDKRequestOptions): Promise<AccountResponse>;
 //# sourceMappingURL=getAccount.d.ts.map

package/dist/esm/services/getAccount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getAccount.d.ts","sourceRoot":"","sources":["../../../src/services/getAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAM1B"}
+{"version":3,"file":"getAccount.d.ts","sourceRoot":"","sources":["../../../src/services/getAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAK1B"}

package/dist/esm/services/getAccount.js

@@ -1,31 +1,25 @@
-import { buildUrl, request } from '../utils/request.js';
+import { requireProvider } from '../client/requireProvider.js';
 /**
- * Get account information including balances, positions, and open orders.
+ * Get account information (balances, margin, fee tier, typed config).
+ * Delegates to the registered venue plugin (direct-to-venue); requires the
+ * provider plugin to be registered on the client.
  *
- * @param client - The SDK client instance
- * @param params - Request parameters
- * @param options - Request options (e.g., AbortSignal)
- * @returns Account details
- * @throws {HTTPError} On API error responses
- * @throws {PerpsError} On network or parsing errors
+ * Use {@link getPositions} and {@link getOrders} to fetch positions and orders
+ * separately.
  *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
  * @example
  * ```ts
- * const client = createPerpsClient({ integrator: 'my-app' })
  * const account = await getAccount(client, {
- *   dex: 'hyperliquid',
- *   address: '0x1234...'
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
  * })
- * console.log(account.balances) // [{ currency: 'USDC', amount: '10000.00' }]
- * console.log(account.positions) // [{ symbol: 'BTC', side: 'LONG', ... }]
- * console.log(account.openOrders) // [{ id: '123', symbol: 'BTC', ... }]
+ * console.log(account.balances)
  * ```
+ * @public
  */
 export async function getAccount(client, params, options) {
-    const url = buildUrl(`${client.config.apiUrl}/account`, {
-        dex: params.dex,
-        address: params.address,
-    });
-    return request(client.config, url, {}, options);
+    return requireProvider(client, params.provider).getAccount({ address: params.address }, options);
 }
 //# sourceMappingURL=getAccount.js.map

package/dist/esm/services/getAccount.js.map

@@ -1 +1 @@
-{"version":3,"file":"getAccount.js","sourceRoot":"","sources":["../../../src/services/getAccount.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AASvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAsB,EACtB,MAAwB,EACxB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,UAAU,EAAE;QACtD,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAA;IACF,OAAO,OAAO,CAAkB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AAClE,CAAC"}
+{"version":3,"file":"getAccount.js","sourceRoot":"","sources":["../../../src/services/getAccount.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAc9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAsB,EACtB,MAAwB,EACxB,OAA2B;IAE3B,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,CACxD,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAC3B,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/esm/services/getActivity.d.ts

@@ -0,0 +1,39 @@
+import type { ActivitiesResponse, ActivityType } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getActivity}.
+ *
+ * @public
+ */
+export interface GetActivityParams {
+    provider: string;
+    address: Address;
+    limit?: number;
+    cursor?: string;
+    /** Filter: activity after this timestamp (ms) */
+    startTime?: number;
+    /** Filter: activity before this timestamp (ms) */
+    endTime?: number;
+    type?: ActivityType[];
+}
+/**
+ * Get account activity (deposits, withdrawals, liquidations, funding payments).
+ * Delegates to the registered venue plugin (direct-to-venue); requires the
+ * provider plugin to be registered on the client.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
+ * @example
+ * ```ts
+ * const { items, pagination } = await getActivity(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ *   limit: 50,
+ * })
+ * ```
+ * @public
+ */
+export declare function getActivity(client: PerpsSDKClient, params: GetActivityParams, options?: SDKRequestOptions): Promise<ActivitiesResponse>;
+//# sourceMappingURL=getActivity.d.ts.map

package/dist/esm/services/getActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getActivity.d.ts","sourceRoot":"","sources":["../../../src/services/getActivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,YAAY,EAAE,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAY7B"}

package/dist/esm/services/getActivity.js

@@ -0,0 +1,29 @@
+import { requireProvider } from '../client/requireProvider.js';
+/**
+ * Get account activity (deposits, withdrawals, liquidations, funding payments).
+ * Delegates to the registered venue plugin (direct-to-venue); requires the
+ * provider plugin to be registered on the client.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
+ * @example
+ * ```ts
+ * const { items, pagination } = await getActivity(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ *   limit: 50,
+ * })
+ * ```
+ * @public
+ */
+export async function getActivity(client, params, options) {
+    return requireProvider(client, params.provider).getActivity({
+        address: params.address,
+        limit: params.limit,
+        cursor: params.cursor,
+        startTime: params.startTime,
+        endTime: params.endTime,
+        type: params.type,
+    }, options);
+}
+//# sourceMappingURL=getActivity.js.map

package/dist/esm/services/getActivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getActivity.js","sourceRoot":"","sources":["../../../src/services/getActivity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAqB9D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAsB,EACtB,MAAyB,EACzB,OAA2B;IAE3B,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,CACzD;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/esm/services/getAssets.d.ts

@@ -0,0 +1,27 @@
+import type { AssetsResponse } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getAssets}.
+ *
+ * @public
+ */
+export interface GetAssetsParams {
+    provider: string;
+}
+/**
+ * Get the token/asset registry for a provider. Thin pass-through to the
+ * LI.FI backend's Valkey-cached `/perps/assets` route, which centralises the
+ * `asset id → symbol → logoURI` join so the SDK never calls a provider's
+ * REST API directly for static registry data.
+ *
+ * @throws {PerpsError} On backend, network, or parsing errors.
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { assets } = await getAssets(client, { provider: 'lighter' })
+ * ```
+ * @public
+ */
+export declare function getAssets(client: PerpsSDKClient, params: GetAssetsParams, options?: SDKRequestOptions): Promise<AssetsResponse>;
+//# sourceMappingURL=getAssets.d.ts.map

package/dist/esm/services/getAssets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAssets.d.ts","sourceRoot":"","sources":["../../../src/services/getAssets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAKzB"}

package/dist/esm/services/getAssets.js

@@ -0,0 +1,22 @@
+import { buildUrl, request } from '../transport/request.js';
+/**
+ * Get the token/asset registry for a provider. Thin pass-through to the
+ * LI.FI backend's Valkey-cached `/perps/assets` route, which centralises the
+ * `asset id → symbol → logoURI` join so the SDK never calls a provider's
+ * REST API directly for static registry data.
+ *
+ * @throws {PerpsError} On backend, network, or parsing errors.
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { assets } = await getAssets(client, { provider: 'lighter' })
+ * ```
+ * @public
+ */
+export async function getAssets(client, params, options) {
+    const url = buildUrl(`${client.config.apiUrl}/assets`, {
+        provider: params.provider,
+    });
+    return request(client.config, url, {}, options);
+}
+//# sourceMappingURL=getAssets.js.map

package/dist/esm/services/getAssets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAssets.js","sourceRoot":"","sources":["../../../src/services/getAssets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAa3D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAsB,EACtB,MAAuB,EACvB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,EAAE;QACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAA;IACF,OAAO,OAAO,CAAiB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AACjE,CAAC"}

package/dist/esm/services/getFills.d.ts

@@ -0,0 +1,38 @@
+import type { FillsResponse } from '@lifi/perps-types';
+import type { Address } from 'viem';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getFills}.
+ *
+ * @public
+ */
+export interface GetFillsParams {
+    provider: string;
+    address: Address;
+    limit?: number;
+    cursor?: string;
+    /** Filter: fills after this timestamp (ms) */
+    startTime?: number;
+    /** Filter: fills before this timestamp (ms) */
+    endTime?: number;
+}
+/**
+ * Get order fills for an account. Delegates to the registered venue plugin
+ * (direct-to-venue); requires the provider plugin to be registered on the
+ * client.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
+ * @example
+ * ```ts
+ * const { items, pagination } = await getFills(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ *   limit: 50,
+ * })
+ * ```
+ * @public
+ */
+export declare function getFills(client: PerpsSDKClient, params: GetFillsParams, options?: SDKRequestOptions): Promise<FillsResponse>;
+//# sourceMappingURL=getFills.d.ts.map

package/dist/esm/services/getFills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFills.d.ts","sourceRoot":"","sources":["../../../src/services/getFills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAWxB"}

package/dist/esm/services/getFills.js

@@ -0,0 +1,28 @@
+import { requireProvider } from '../client/requireProvider.js';
+/**
+ * Get order fills for an account. Delegates to the registered venue plugin
+ * (direct-to-venue); requires the provider plugin to be registered on the
+ * client.
+ *
+ * @throws {PerpsError} When the provider plugin is not registered, or on
+ *   backend / network / parsing errors.
+ * @example
+ * ```ts
+ * const { items, pagination } = await getFills(client, {
+ *   provider: 'hyperliquid',
+ *   address: '0x1234...',
+ *   limit: 50,
+ * })
+ * ```
+ * @public
+ */
+export async function getFills(client, params, options) {
+    return requireProvider(client, params.provider).getFills({
+        address: params.address,
+        limit: params.limit,
+        cursor: params.cursor,
+        startTime: params.startTime,
+        endTime: params.endTime,
+    }, options);
+}
+//# sourceMappingURL=getFills.js.map

package/dist/esm/services/getFills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFills.js","sourceRoot":"","sources":["../../../src/services/getFills.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAoB9D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAsB,EACtB,MAAsB,EACtB,OAA2B;IAE3B,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CACtD;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/esm/services/getMarket.d.ts

@@ -1,27 +1,34 @@
 import type { Market } from '@lifi/perps-types';
-import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getMarket}.
+ *
+ * @public
+ */
 export interface GetMarketParams {
-    /** DEX to get market from (e.g., 'hyperliquid') */
-    dex: string;
-    /** Market symbol (e.g., 'BTC') */
-    symbol: string;
+    provider: string;
+    /**
+     * Opaque provider `Market.id` (e.g. `"BTC"`, `"xyz:PURR"`, `"@142"` on
+     * Hyperliquid; `"0"`, `"1"` on Lighter). Pass a `displaySymbol` here and
+     * lookups will 404 for providers where the two diverge.
+     */
+    marketId: string;
 }
 /**
- * Get a specific market by symbol.
- *
- * @param client - The SDK client instance
- * @param params - Request parameters
- * @param options - Request options (e.g., AbortSignal)
- * @returns Market details
- * @throws {HTTPError} On API error responses (e.g., 404 if market not found)
- * @throws {PerpsError} On network or parsing errors
+ * Get a specific market by its opaque marketId. Requests the single market
+ * from the backend `/markets` route (filtered by `marketIds`) and returns the
+ * first match; the backend responds 404 (thrown as a {@link PerpsError}) when
+ * nothing matches.
  *
+ * @throws {PerpsError} On backend (e.g. 404), network, or parsing errors.
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
- * const market = await getMarket(client, { dex: 'hyperliquid', symbol: 'BTC' })
- * console.log(market) // { symbol: 'BTC', markPrice: '95000.00', ... }
+ * const market = await getMarket(client, { provider: 'hyperliquid', marketId: 'BTC' })
+ * console.log(market.baseAsset.displaySymbol)
  * ```
+ * @public
  */
 export declare function getMarket(client: PerpsSDKClient, params: GetMarketParams, options?: SDKRequestOptions): Promise<Market>;
 //# sourceMappingURL=getMarket.d.ts.map

package/dist/esm/services/getMarket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getMarket.d.ts","sourceRoot":"","sources":["../../../src/services/getMarket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAKjB"}
+{"version":3,"file":"getMarket.d.ts","sourceRoot":"","sources":["../../../src/services/getMarket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAmB,MAAM,mBAAmB,CAAA;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/dist/esm/services/getMarket.js

@@ -1,25 +1,25 @@
-import { buildUrl, request } from '../utils/request.js';
+import { buildUrl, request } from '../transport/request.js';
 /**
- * Get a specific market by symbol.
- *
- * @param client - The SDK client instance
- * @param params - Request parameters
- * @param options - Request options (e.g., AbortSignal)
- * @returns Market details
- * @throws {HTTPError} On API error responses (e.g., 404 if market not found)
- * @throws {PerpsError} On network or parsing errors
+ * Get a specific market by its opaque marketId. Requests the single market
+ * from the backend `/markets` route (filtered by `marketIds`) and returns the
+ * first match; the backend responds 404 (thrown as a {@link PerpsError}) when
+ * nothing matches.
  *
+ * @throws {PerpsError} On backend (e.g. 404), network, or parsing errors.
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
- * const market = await getMarket(client, { dex: 'hyperliquid', symbol: 'BTC' })
- * console.log(market) // { symbol: 'BTC', markPrice: '95000.00', ... }
+ * const market = await getMarket(client, { provider: 'hyperliquid', marketId: 'BTC' })
+ * console.log(market.baseAsset.displaySymbol)
  * ```
+ * @public
  */
 export async function getMarket(client, params, options) {
-    const url = buildUrl(`${client.config.apiUrl}/markets/${params.symbol}`, {
-        dex: params.dex,
+    const url = buildUrl(`${client.config.apiUrl}/markets`, {
+        provider: params.provider,
+        marketIds: params.marketId,
     });
-    return request(client.config, url, {}, options);
+    const { markets } = await request(client.config, url, {}, options);
+    return markets[0];
 }
 //# sourceMappingURL=getMarket.js.map

package/dist/esm/services/getMarket.js.map

@@ -1 +1 @@
-{"version":3,"file":"getMarket.js","sourceRoot":"","sources":["../../../src/services/getMarket.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AASvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAsB,EACtB,MAAuB,EACvB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,EAAE;QACvE,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC,CAAA;IACF,OAAO,OAAO,CAAS,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AACzD,CAAC"}
+{"version":3,"file":"getMarket.js","sourceRoot":"","sources":["../../../src/services/getMarket.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAmB3D;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAsB,EACtB,MAAuB,EACvB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,UAAU,EAAE;QACtD,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,QAAQ;KAC3B,CAAC,CAAA;IACF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAC/B,MAAM,CAAC,MAAM,EACb,GAAG,EACH,EAAE,EACF,OAAO,CACR,CAAA;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC"}

package/dist/esm/services/getMarkets.d.ts

@@ -1,25 +1,28 @@
 import type { MarketsResponse } from '@lifi/perps-types';
-import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getMarkets}.
+ *
+ * @public
+ */
 export interface GetMarketsParams {
-    /** DEX to get markets from (e.g., 'hyperliquid') */
-    dex: string;
+    provider: string;
+    /** Optional filter — opaque `Market.id`s (not display symbols). */
+    marketIds?: string[];
 }
 /**
- * Get all available markets for a DEX.
- *
- * @param client - The SDK client instance
- * @param params - Request parameters
- * @param options - Request options (e.g., AbortSignal)
- * @returns List of available markets
- * @throws {HTTPError} On API error responses
- * @throws {PerpsError} On network or parsing errors
+ * Get all available markets for a provider. Thin pass-through to the LI.FI
+ * backend's Valkey-cached `/perps/markets` route — the canonical source of
+ * public market data for widget consumers.
  *
+ * @throws {PerpsError} On backend, network, or parsing errors.
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
- * const { markets } = await getMarkets(client, { dex: 'hyperliquid' })
- * console.log(markets) // [{ symbol: 'BTC', name: 'Bitcoin', ... }]
+ * const { markets } = await getMarkets(client, { provider: 'hyperliquid' })
  * ```
+ * @public
  */
 export declare function getMarkets(client: PerpsSDKClient, params: GetMarketsParams, options?: SDKRequestOptions): Promise<MarketsResponse>;
 //# sourceMappingURL=getMarkets.d.ts.map

package/dist/esm/services/getMarkets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getMarkets.d.ts","sourceRoot":"","sources":["../../../src/services/getMarkets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAG1B"}
+{"version":3,"file":"getMarkets.d.ts","sourceRoot":"","sources":["../../../src/services/getMarkets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAM1B"}

package/dist/esm/services/getMarkets.js

@@ -1,23 +1,22 @@
-import { buildUrl, request } from '../utils/request.js';
+import { buildUrl, request } from '../transport/request.js';
 /**
- * Get all available markets for a DEX.
- *
- * @param client - The SDK client instance
- * @param params - Request parameters
- * @param options - Request options (e.g., AbortSignal)
- * @returns List of available markets
- * @throws {HTTPError} On API error responses
- * @throws {PerpsError} On network or parsing errors
+ * Get all available markets for a provider. Thin pass-through to the LI.FI
+ * backend's Valkey-cached `/perps/markets` route — the canonical source of
+ * public market data for widget consumers.
  *
+ * @throws {PerpsError} On backend, network, or parsing errors.
  * @example
  * ```ts
  * const client = createPerpsClient({ integrator: 'my-app' })
- * const { markets } = await getMarkets(client, { dex: 'hyperliquid' })
- * console.log(markets) // [{ symbol: 'BTC', name: 'Bitcoin', ... }]
+ * const { markets } = await getMarkets(client, { provider: 'hyperliquid' })
  * ```
+ * @public
  */
 export async function getMarkets(client, params, options) {
-    const url = buildUrl(`${client.config.apiUrl}/markets`, { dex: params.dex });
+    const url = buildUrl(`${client.config.apiUrl}/markets`, {
+        provider: params.provider,
+        marketIds: params.marketIds?.join(','),
+    });
     return request(client.config, url, {}, options);
 }
 //# sourceMappingURL=getMarkets.js.map

package/dist/esm/services/getMarkets.js.map

@@ -1 +1 @@
-{"version":3,"file":"getMarkets.js","sourceRoot":"","sources":["../../../src/services/getMarkets.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAOvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAsB,EACtB,MAAwB,EACxB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;IAC5E,OAAO,OAAO,CAAkB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AAClE,CAAC"}
+{"version":3,"file":"getMarkets.js","sourceRoot":"","sources":["../../../src/services/getMarkets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAe3D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAsB,EACtB,MAAwB,EACxB,OAA2B;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,UAAU,EAAE;QACtD,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC;KACvC,CAAC,CAAA;IACF,OAAO,OAAO,CAAkB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;AAClE,CAAC"}

package/dist/esm/services/getMeta.d.ts

@@ -0,0 +1,19 @@
+import type { Meta } from '@lifi/perps-types';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Get platform metadata: the API version and any active platform-level notices.
+ *
+ * @returns Platform version and the list of active notices
+ * @throws {PerpsError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { version, notices } = await getMeta(client)
+ * ```
+ * @public
+ */
+export declare function getMeta(client: PerpsSDKClient, options?: SDKRequestOptions): Promise<Meta>;
+//# sourceMappingURL=getMeta.d.ts.map

package/dist/esm/services/getMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMeta.d.ts","sourceRoot":"","sources":["../../../src/services/getMeta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;;;;;;;;;;GAaG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/esm/services/getMeta.js

@@ -0,0 +1,19 @@
+import { request } from '../transport/request.js';
+/**
+ * Get platform metadata: the API version and any active platform-level notices.
+ *
+ * @returns Platform version and the list of active notices
+ * @throws {PerpsError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { version, notices } = await getMeta(client)
+ * ```
+ * @public
+ */
+export async function getMeta(client, options) {
+    return request(client.config, `${client.config.apiUrl}/meta`, {}, options);
+}
+//# sourceMappingURL=getMeta.js.map

package/dist/esm/services/getMeta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMeta.js","sourceRoot":"","sources":["../../../src/services/getMeta.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAIjD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAsB,EACtB,OAA2B;IAE3B,OAAO,OAAO,CACZ,MAAM,CAAC,MAAM,EACb,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,OAAO,EAC9B,EAAE,EACF,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/esm/services/getOhlcv.d.ts

@@ -1,40 +1,36 @@
 import type { OhlcvInterval, OhlcvResponse } from '@lifi/perps-types';
-import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+import type { SDKRequestOptions } from '../types/config.js';
+import type { PerpsSDKClient } from '../types/provider.js';
+/**
+ * Parameters for {@link getOhlcv}.
+ *
+ * @public
+ */
 export interface GetOhlcvParams {
-    /** DEX to get OHLCV from (e.g., 'hyperliquid') */
-    dex: string;
-    /** Market symbol (e.g., 'BTC') */
-    symbol: string;
-    /** Candle interval */
+    provider: string;
+    /** Opaque provider `Market.id` (not `displaySymbol`). */
+    marketId: string;
     interval: OhlcvInterval;
-    /** Start time (Unix timestamp in milliseconds) */
+    /** Unix timestamp in milliseconds */
     startTime?: number;
-    /** End time (Unix timestamp in milliseconds) */
+    /** Unix timestamp in milliseconds */
     endTime?: number;
-    /** Maximum number of candles to return */
     limit?: number;
 }
 /**
  * Get OHLCV (candlestick) data for a market.
  *
- * @param client - The SDK client instance
- * @param params - Request parameters
- * @param options - Request options (e.g., AbortSignal)
- * @returns OHLCV candle data
- * @throws {HTTPError} On API error responses
- * @throws {PerpsError} On network or parsing errors
- *
+ * @throws {PerpsError} On backend, network, or parsing errors.
  * @example
  * ```ts
- * const client = createPerpsClient({ integrator: 'my-app' })
  * const { candles } = await getOhlcv(client, {
- *   dex: 'hyperliquid',
- *   symbol: 'BTC',
+ *   provider: 'hyperliquid',
+ *   marketId: 'BTC',
  *   interval: '1h',
- *   limit: 100
+ *   limit: 100,
  * })
- * console.log(candles) // [{ t: 1704067200000, o: '94000', h: '95000', ... }]
  * ```
+ * @public
  */
 export declare function getOhlcv(client: PerpsSDKClient, params: GetOhlcvParams, options?: SDKRequestOptions): Promise<OhlcvResponse>;
 //# sourceMappingURL=getOhlcv.d.ts.map