Feature: Get symbol/coin name from pair ID (spot)

[xdmaury]

Description of the Desired Feature

While using the SymbolConverter there are helper methods like:

• getAssetId(symbol)
• getSpotPairId(symbol)
• getSzDecimals(symbol)

However, there is currently no way to retrieve the symbol or coin name from a given pair ID.

Motivation and Use Case

In some scenarios, we only have access to the pair ID, for example:

"@107"

But we cannot resolve it back to its corresponding symbol (e.g. "HYPE/USDC").

This becomes a limitation when:

• Handling subscriptions or websocket events
• Processing data returned from APIs that use pair IDs
• Performing follow-up operations that require the symbol

Proposed Solution (optional)

It would be useful to have a method like:

converter.getSymbolFromPairId("@107");
// "HYPE/USDC"

Additional Information (optional)

In my use case, I frequently receive @107 but have no way to determine the corresponding market without maintaining my own mapping.

[xdmaury]

The solution that i'm using at the moment:

/// ============================================================================
/// Pair Resolver Creation (for spot orders)
/// ============================================================================

/**
 * Creates a pair resolver function that maps spot pair IDs to human-readable names.
 * This is necessary for spot orders where the coin is specified as a pair ID (e.g., "@1035").
 */
export async function createPairResolver(infoClient: InfoClient) {
  const [spotMeta] = await infoClient.spotMetaAndAssetCtxs();

  // Map: "@123" → "BASE/QUOTE"
  const pairIdToName = new Map<string, string>();

  for (const pair of spotMeta.universe) {
    const baseToken = spotMeta.tokens.find(t => t.index === pair.tokens[0]);
    const quoteToken = spotMeta.tokens.find(t => t.index === pair.tokens[1]);

    if (!baseToken || !quoteToken) continue;

    const pairName = `${baseToken.name}/${quoteToken.name}`;
    pairIdToName.set(pair.name, pairName);
  }

  return {
    getPairNameFromId: (pairId: string) => {
      return pairIdToName.get(pairId);
    }
  };
}