feat(examples): add go-account-list-products script

Adds a new example script that fetches available trading pairs for a Go
Account via GET /api/prime/trading/v1/accounts/{accountId}/products.
Displays a formatted table of available/disabled pairs with base currency,
quote currency, and margin support. Updates go-account-workflows.md with
documentation, env var requirements, and usage.

Ticket: CAAS-2079

Author: alia-bitgo

examples/docs/go-account-workflows.md

@@ -165,7 +165,26 @@ const url = coin.url(`/wallet/${walletId}/policy/rule`);
 const result = await bitgo.put(url).send(body).result();
 ```
 
-### 8. Sign Transaction — sign only (Step 2 of 3)
+### 8. Go Account List Products — view available trading pairs
+**File:** `examples/ts/go-account/go-account-list-products.ts`
+
+Fetches all trading products (pairs) available for a prime trading account.
+Use this before placing an order to find valid product symbols.
+
+**Best for:**
+- Discovering which trading pairs are enabled for your account
+- Validating product symbols before placing an order
+
+**Example:**
+```typescript
+const url = (bitgo as any).microservicesUrl(
+  `/api/prime/trading/v1/accounts/${accountId}/products`
+);
+const response = await (bitgo as any).get(url).result();
+// response.data → array of { id, baseCurrency, quoteCurrency, isTradeDisabled, ... }
+```
+
+### 9. Sign Transaction — sign only (Step 2 of 3)
 **File:** `examples/ts/go-account/sign-transaction.ts`
 
 Signs a pre-built payload and outputs the hex signature. Use this when the build
@@ -339,6 +358,9 @@ const usdtAddress = await wallet.createAddress({
    # Sign only: sign a pre-built payload (Step 2 of 3)
    OFC_WALLET_ID=your_wallet_id OFC_WALLET_PASSPHRASE=your_passphrase OFC_PREBUILD_PAYLOAD='{"..."}' npx tsx sign-transaction.ts
 
+   # List available trading pairs for a Go Account
+   OFC_WALLET_ID=your_wallet_id npx tsx go-account-list-products.ts
+
    # List whitelist policy rules on a wallet
    OFC_WALLET_ID=your_wallet_id npx tsx go-account-whitelist-list.ts
 

examples/ts/go-account/go-account-list-products.ts

@@ -0,0 +1,114 @@
+/**
+ * Go Account — List Trading Products
+ *
+ * Retrieves the available trading pairs (products) for a prime trading account.
+ * Use this to discover valid product symbols before placing a trade order.
+ *
+ * API: GET /api/prime/trading/v1/accounts/{ACCOUNT_ID}/products
+ *
+ * Required environment variables (in examples/.env):
+ *   TESTNET_ACCESS_TOKEN   - your BitGo access token (must have trade_trade scope)
+ *   OFC_WALLET_ID          - your Go Account wallet ID
+ *
+ * Copyright 2025, BitGo, Inc.  All Rights Reserved.
+ */
+
+import { BitGoAPI } from '@bitgo/sdk-api';
+require('dotenv').config({ path: '../../../.env' });
+
+// Initialize BitGo SDK
+const bitgo = new BitGoAPI({
+  accessToken: process.env.TESTNET_ACCESS_TOKEN,
+  env: 'staging', // Change to 'production' for mainnet
+});
+
+// ---------------------------------------------------------------------------
+// Configuration — update these values or set them as environment variables
+// ---------------------------------------------------------------------------
+
+/**
+ * Your Go Account wallet ID.
+ * Find this in the BitGo portal or from the wallet object in your API responses.
+ */
+const accountId = process.env.OFC_WALLET_ID || 'your_wallet_id';
+
+// ---------------------------------------------------------------------------
+
+interface Product {
+  id: string;
+  name: string;
+  baseCurrency: string;
+  quoteCurrency: string;
+  baseIncrement: string;
+  quoteIncrement: string;
+  isTradeDisabled: boolean;
+  isMarginTradeSupported: boolean;
+}
+
+interface ListProductsResponse {
+  data: Product[];
+}
+
+async function main() {
+  console.log('=== Go Account — List Trading Products ===\n');
+
+  const url = (bitgo as any).microservicesUrl(
+    `/api/prime/trading/v1/accounts/${accountId}/products`
+  );
+
+  console.log(`Fetching trading products for account ${accountId}...`);
+  const response: ListProductsResponse = await (bitgo as any).get(url).result();
+
+  const products: Product[] = response.data ?? [];
+
+  if (products.length === 0) {
+    console.log('No trading products found for this account.');
+    return;
+  }
+
+  console.log(`✓ Found ${products.length} product(s)\n`);
+
+  // Display a formatted table of available products
+  const availableProducts = products.filter((p) => !p.isTradeDisabled);
+  const disabledProducts = products.filter((p) => p.isTradeDisabled);
+
+  console.log('Available trading pairs:');
+  console.log('-'.repeat(70));
+  console.log(
+    `${'Product ID'.padEnd(24)} ${'Base'.padEnd(12)} ${'Quote'.padEnd(12)} ${'Margin'}`
+  );
+  console.log('-'.repeat(70));
+
+  for (const p of availableProducts) {
+    const margin = p.isMarginTradeSupported ? 'yes' : 'no';
+    console.log(
+      `${p.id.padEnd(24)} ${p.baseCurrency.padEnd(12)} ${p.quoteCurrency.padEnd(12)} ${margin}`
+    );
+  }
+
+  if (disabledProducts.length > 0) {
+    console.log(`\n${disabledProducts.length} pair(s) currently disabled for trading:`);
+    for (const p of disabledProducts) {
+      console.log(`  ${p.id} (${p.baseCurrency}/${p.quoteCurrency})`);
+    }
+  }
+
+  console.log('\nFull response:');
+  console.log(JSON.stringify(response, null, 2));
+
+  console.log('\n' + '='.repeat(60));
+  console.log('SUMMARY');
+  console.log('='.repeat(60));
+  console.log(`  Account ID        : ${accountId}`);
+  console.log(`  Total products    : ${products.length}`);
+  console.log(`  Available to trade: ${availableProducts.length}`);
+  console.log(`  Disabled          : ${disabledProducts.length}`);
+  console.log('='.repeat(60));
+
+  console.log('\nNext step: use a product ID above with go-account-place-order.ts');
+}
+
+main().catch((e) => {
+  console.error('\n❌ Error listing trading products:', e);
+  process.exit(1);
+});