@nktkas/hyperliquid 0.32.1 → 0.32.2

package/src/api/exchange/mod.ts

@@ -38,7 +38,7 @@
  */
 
 export { ApiRequestError } from "./_methods/_base/errors.js";
-export type { ExchangeMultiSigConfig, ExchangeSingleWalletConfig } from "./_methods/_base/execute.js";
+export type { ExchangeConfig, ExchangeMultiSigConfig, ExchangeSingleWalletConfig } from "./_methods/_base/execute.js";
 
 export * from "./_methods/agentEnableDexAbstraction.js";
 export * from "./_methods/agentSetAbstraction.js";

package/src/api/info/_methods/activeAssetData.ts

@@ -100,10 +100,10 @@ export type ActiveAssetDataParameters = Omit<v.InferInput<typeof ActiveAssetData
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await activeAssetData(
- *   { transport },
- *   { user: "0x...", coin: "ETH" },
- * );
+ * const data = await activeAssetData({ transport }, {
+ *   user: "0x...",
+ *   coin: "ETH",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-active-asset-data

package/src/api/info/_methods/alignedQuoteTokenInfo.ts

@@ -76,10 +76,9 @@ export type AlignedQuoteTokenInfoParameters = Omit<v.InferInput<typeof AlignedQu
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await alignedQuoteTokenInfo(
- *   { transport },
- *   { token: 1328 },
- * );
+ * const data = await alignedQuoteTokenInfo({ transport }, {
+ *   token: 1328,
+ * });
  * ```
  *
  * @see null

package/src/api/info/_methods/approvedBuilders.ts

@@ -54,10 +54,9 @@ export type ApprovedBuildersParameters = Omit<v.InferInput<typeof ApprovedBuilde
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await approvedBuilders(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await approvedBuilders({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-approved-builders-for-user

package/src/api/info/_methods/blockDetails.ts

@@ -79,10 +79,9 @@ export type BlockDetailsParameters = Omit<v.InferInput<typeof BlockDetailsReques
  *
  * const transport = new HttpTransport(); // only `HttpTransport` supports this API
  *
- * const data = await blockDetails(
- *   { transport },
- *   { height: 123 },
- * );
+ * const data = await blockDetails({ transport }, {
+ *   height: 123,
+ * });
  * ```
  *
  * @see null

package/src/api/info/_methods/borrowLendReserveState.ts

@@ -95,10 +95,9 @@ export type BorrowLendReserveStateParameters = Omit<v.InferInput<typeof BorrowLe
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await borrowLendReserveState(
- *   { transport },
- *   { token: 0 },
- * );
+ * const data = await borrowLendReserveState({ transport }, {
+ *   token: 0,
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-borrow-lend-reserve-state

package/src/api/info/_methods/borrowLendUserState.ts

@@ -91,10 +91,9 @@ export type BorrowLendUserStateParameters = Omit<v.InferInput<typeof BorrowLendU
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await borrowLendUserState(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await borrowLendUserState({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-borrow-lend-user-state

package/src/api/info/_methods/candleSnapshot.ts

@@ -99,14 +99,11 @@ export type CandleSnapshotParameters = v.InferInput<typeof CandleSnapshotRequest
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await candleSnapshot(
- *   { transport },
- *   {
- *     coin: "ETH",
- *     interval: "1h",
- *     startTime: Date.now() - 1000 * 60 * 60 * 24,
- *   },
- * );
+ * const data = await candleSnapshot({ transport }, {
+ *   coin: "ETH",
+ *   interval: "1h",
+ *   startTime: Date.now() - 1000 * 60 * 60 * 24,
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot

package/src/api/info/_methods/clearinghouseState.ts

@@ -197,10 +197,9 @@ export type ClearinghouseStateParameters = Omit<v.InferInput<typeof Clearinghous
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await clearinghouseState(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await clearinghouseState({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary

package/src/api/info/_methods/delegations.ts

@@ -67,10 +67,9 @@ export type DelegationsParameters = Omit<v.InferInput<typeof DelegationsRequest>
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await delegations(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await delegations({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-delegations

package/src/api/info/_methods/delegatorHistory.ts

@@ -100,10 +100,9 @@ export type DelegatorHistoryParameters = Omit<v.InferInput<typeof DelegatorHisto
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await delegatorHistory(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await delegatorHistory({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-history

package/src/api/info/_methods/delegatorRewards.ts

@@ -64,10 +64,9 @@ export type DelegatorRewardsParameters = Omit<v.InferInput<typeof DelegatorRewar
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await delegatorRewards(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await delegatorRewards({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-rewards

package/src/api/info/_methods/delegatorSummary.ts

@@ -72,10 +72,9 @@ export type DelegatorSummaryParameters = Omit<v.InferInput<typeof DelegatorSumma
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await delegatorSummary(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await delegatorSummary({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-summary

package/src/api/info/_methods/extraAgents.ts

@@ -64,10 +64,9 @@ export type ExtraAgentsParameters = Omit<v.InferInput<typeof ExtraAgentsRequest>
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await extraAgents(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await extraAgents({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see null

package/src/api/info/_methods/frontendOpenOrders.ts

@@ -57,10 +57,9 @@ export type FrontendOpenOrdersParameters = Omit<v.InferInput<typeof FrontendOpen
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await frontendOpenOrders(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await frontendOpenOrders({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-open-orders-with-additional-frontend-info

package/src/api/info/_methods/fundingHistory.ts

@@ -73,13 +73,10 @@ export type FundingHistoryParameters = Omit<v.InferInput<typeof FundingHistoryRe
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await fundingHistory(
- *   { transport },
- *   {
- *     coin: "ETH",
- *     startTime: Date.now() - 1000 * 60 * 60 * 24,
- *   },
- * );
+ * const data = await fundingHistory({ transport }, {
+ *   coin: "ETH",
+ *   startTime: Date.now() - 1000 * 60 * 60 * 24,
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates

package/src/api/info/_methods/historicalOrders.ts

@@ -93,10 +93,9 @@ export type HistoricalOrdersParameters = Omit<v.InferInput<typeof HistoricalOrde
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await historicalOrders(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await historicalOrders({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-historical-orders

package/src/api/info/_methods/isVip.ts

@@ -54,10 +54,9 @@ export type IsVipParameters = Omit<v.InferInput<typeof IsVipRequest>, "type">;
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await isVip(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await isVip({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see null

package/src/api/info/_methods/l2Book.ts

@@ -83,10 +83,10 @@ export type L2BookParameters = Omit<v.InferInput<typeof L2BookRequest>, "type">;
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await l2Book(
- *   { transport },
- *   { coin: "ETH", nSigFigs: 2 },
- * );
+ * const data = await l2Book({ transport }, {
+ *   coin: "ETH",
+ *   nSigFigs: 2,
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#l2-book-snapshot

package/src/api/info/_methods/leadingVaults.ts

@@ -62,10 +62,9 @@ export type LeadingVaultsParameters = Omit<v.InferInput<typeof LeadingVaultsRequ
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await leadingVaults(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await leadingVaults({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see null

package/src/api/info/_methods/legalCheck.ts

@@ -61,10 +61,9 @@ export type LegalCheckParameters = Omit<v.InferInput<typeof LegalCheckRequest>,
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await legalCheck(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await legalCheck({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see null

package/src/api/info/_methods/marginTable.ts

@@ -68,10 +68,9 @@ export type MarginTableParameters = Omit<v.InferInput<typeof MarginTableRequest>
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await marginTable(
- *   { transport },
- *   { id: 1 },
- * );
+ * const data = await marginTable({ transport }, {
+ *   id: 1,
+ * });
  * ```
  *
  * @see null

package/src/api/info/_methods/maxBuilderFee.ts

@@ -57,10 +57,10 @@ export type MaxBuilderFeeParameters = Omit<v.InferInput<typeof MaxBuilderFeeRequ
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await maxBuilderFee(
- *   { transport },
- *   { user: "0x...", builder: "0x..." },
- * );
+ * const data = await maxBuilderFee({ transport }, {
+ *   user: "0x...",
+ *   builder: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#check-builder-fee-approval

package/src/api/info/_methods/openOrders.ts

@@ -57,10 +57,9 @@ export type OpenOrdersParameters = Omit<v.InferInput<typeof OpenOrdersRequest>,
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await openOrders(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await openOrders({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-open-orders

package/src/api/info/_methods/orderStatus.ts

@@ -105,10 +105,10 @@ export type OrderStatusParameters = Omit<v.InferInput<typeof OrderStatusRequest>
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await orderStatus(
- *   { transport },
- *   { user: "0x...", oid: 12345 },
- * );
+ * const data = await orderStatus({ transport }, {
+ *   user: "0x...",
+ *   oid: 12345,
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-order-status-by-oid-or-cloid

package/src/api/info/_methods/outcomeMeta.ts

@@ -34,7 +34,7 @@ export type OutcomeMetaResponse = {
       /** Name of the side. */
       name: string;
       /** Token identifier for this side. */
-      token: number;
+      token?: number;
     }[];
   }[];
   /** Array of prediction market questions. */
@@ -49,6 +49,8 @@ export type OutcomeMetaResponse = {
     fallbackOutcome: number;
     /** Array of named outcome identifiers. */
     namedOutcomes: number[];
+    /** Array of settled named outcome identifiers. */
+    settledNamedOutcomes: number[];
   }[];
 };
 

package/src/api/info/_methods/perpAnnotation.ts

@@ -27,6 +27,10 @@ export type PerpAnnotationResponse = {
   category: string;
   /** Human-readable description of the category. */
   description: string;
+  /** Display name for frontends to use instead of the L1 name. */
+  displayName?: string;
+  /** Keywords used as hints to match against searches. */
+  keywords?: string[];
 } | null;
 
 // ============================================================
@@ -57,7 +61,9 @@ export type PerpAnnotationParameters = Omit<v.InferInput<typeof PerpAnnotationRe
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await perpAnnotation({ transport }, { coin: "BTC" });
+ * const data = await perpAnnotation({ transport }, {
+ *   coin: "BTC",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perp-annotation

package/src/api/info/_methods/perpConciseAnnotations.ts

@@ -0,0 +1,74 @@
+import * as v from "valibot";
+
+// ============================================================
+// API Schemas
+// ============================================================
+
+/**
+ * Request concise annotations for all perpetual assets.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-concise-perp-annotations
+ */
+export const PerpConciseAnnotationsRequest = /* @__PURE__ */ (() => {
+  return v.object({
+    /** Type of request. */
+    type: v.literal("perpConciseAnnotations"),
+  });
+})();
+export type PerpConciseAnnotationsRequest = v.InferOutput<typeof PerpConciseAnnotationsRequest>;
+
+/**
+ * Array of tuples mapping coin names to their concise annotations.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-concise-perp-annotations
+ */
+export type PerpConciseAnnotationsResponse = [
+  /** Coin symbol. */
+  coin: string,
+  /** Concise annotation. */
+  annotation: {
+    /** Classification category assigned to the perpetual. */
+    category: string;
+    /** Display name for frontends to use instead of the L1 name. */
+    displayName?: string;
+    /** Keywords used as hints to match against searches. */
+    keywords?: string[];
+  },
+][];
+
+// ============================================================
+// Execution Logic
+// ============================================================
+
+import { parse } from "../../../_base.js";
+import type { InfoConfig } from "./_base/types.js";
+
+/**
+ * Request concise annotations for all perpetual assets.
+ *
+ * @param config General configuration for Info API requests.
+ * @param signal {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal} to cancel the request.
+ * @return Array of tuples mapping coin names to their concise annotations.
+ *
+ * @throws {ValidationError} When the request parameters fail validation (before sending).
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { perpConciseAnnotations } from "@nktkas/hyperliquid/api/info";
+ *
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * const data = await perpConciseAnnotations({ transport });
+ * ```
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-concise-perp-annotations
+ */
+export function perpConciseAnnotations(
+  config: InfoConfig,
+  signal?: AbortSignal,
+): Promise<PerpConciseAnnotationsResponse> {
+  const request = parse(PerpConciseAnnotationsRequest, {
+    type: "perpConciseAnnotations",
+  });
+  return config.transport.request("info", request, signal);
+}

package/src/api/info/_methods/perpDexLimits.ts

@@ -74,10 +74,9 @@ export type PerpDexLimitsParameters = Omit<v.InferInput<typeof PerpDexLimitsRequ
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await perpDexLimits(
- *   { transport },
- *   { dex: "test" },
- * );
+ * const data = await perpDexLimits({ transport }, {
+ *   dex: "test",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-builder-deployed-perp-market-limits

package/src/api/info/_methods/perpDexStatus.ts

@@ -58,7 +58,9 @@ export type PerpDexStatusParameters = Omit<v.InferInput<typeof PerpDexStatusRequ
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await perpDexStatus({ transport }, { dex: "test" });
+ * const data = await perpDexStatus({ transport }, {
+ *   dex: "test",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#get-perp-market-status

package/src/api/info/_methods/portfolio.ts

@@ -84,10 +84,9 @@ export type PortfolioParameters = Omit<v.InferInput<typeof PortfolioRequest>, "t
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await portfolio(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await portfolio({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-portfolio

package/src/api/info/_methods/preTransferCheck.ts

@@ -68,10 +68,10 @@ export type PreTransferCheckParameters = Omit<v.InferInput<typeof PreTransferChe
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await preTransferCheck(
- *   { transport },
- *   { user: "0x...", source: "0x..." },
- * );
+ * const data = await preTransferCheck({ transport }, {
+ *   user: "0x...",
+ *   source: "0x...",
+ * });
  * ```
  *
  * @see null

package/src/api/info/_methods/recentTrades.ts

@@ -83,10 +83,9 @@ export type RecentTradesParameters = Omit<v.InferInput<typeof RecentTradesReques
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await recentTrades(
- *   { transport },
- *   { coin: "ETH" },
- * );
+ * const data = await recentTrades({ transport }, {
+ *   coin: "ETH",
+ * });
  * ```
  *
  * @see null

package/src/api/info/_methods/referral.ts

@@ -203,10 +203,9 @@ export type ReferralParameters = Omit<v.InferInput<typeof ReferralRequest>, "typ
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await referral(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await referral({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-referral-information

package/src/api/info/_methods/spotClearinghouseState.ts

@@ -91,10 +91,9 @@ export type SpotClearinghouseStateParameters = Omit<v.InferInput<typeof SpotClea
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await spotClearinghouseState(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await spotClearinghouseState({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances

package/src/api/info/_methods/spotDeployState.ts

@@ -114,10 +114,9 @@ export type SpotDeployStateParameters = Omit<v.InferInput<typeof SpotDeployState
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await spotDeployState(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await spotDeployState({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-information-about-the-spot-deploy-auction

package/src/api/info/_methods/subAccounts.ts

@@ -73,10 +73,9 @@ export type SubAccountsParameters = Omit<v.InferInput<typeof SubAccountsRequest>
  *
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  *
- * const data = await subAccounts(
- *   { transport },
- *   { user: "0x..." },
- * );
+ * const data = await subAccounts({ transport }, {
+ *   user: "0x...",
+ * });
  * ```
  *
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-subaccounts