GetSwapPrice

Get a price-only quote without transaction data.

Returns a price quote without instructions or transaction data. Use it when you need to display prices in a UI without the overhead of building executable transactions — lighter weight than NewSwapQuoteStream.

This is a one-shot request, not a stream. The server finds the best direct route and uses the simulated output to determine the price.

Request

Rust

struct SwapPriceRequest {
  /// Address of the input mint of the swap.
  inputMint: Pubkey,
  /// Address of the desired output token for the swap.
  outputMint: Pubkey,
  /// Raw number of tokens to swap, not scaled by decimals.
  amount: u64,
  /// If set, constrain quotes to the given set of DEXes.
  dexes: Option<Vec<String>>,
  /// If set, exclude the following DEXes when determining routes.
  excludeDexes: Option<Vec<String>>,
}

TypeScript

interface SwapPriceRequest {
  // Address of the input mint.
  inputMint: Pubkey;
  // Address of the output mint.
  outputMint: Pubkey;
  // Raw number of tokens to swap. Use BigInt.
  amount: number | bigint;
  // If set, constrain to these DEXes.
  dexes?: string[];
  // If set, exclude these DEXes.
  excludeDexes?: string[];
}

Response

Rust

struct SwapPrice {
  /// Identifier for this price quote.
  id: String,
  /// Address of the input mint.
  inputMint: Pubkey,
  /// Address of the output mint.
  outputMint: Pubkey,
  /// Amount that was used for the price.
  amountIn: u64,
  /// The amount out of the best simulated quote.
  amountOut: u64,
}

TypeScript

interface SwapPrice {
  // Identifier for this price quote.
  id: string;
  // Address of the input mint.
  inputMint: Pubkey;
  // Address of the output mint.
  outputMint: Pubkey;
  // Amount used for pricing.
  amountIn: number | bigint;
  // Best simulated output amount.
  amountOut: number | bigint;
}

The response does not include instructions, addressLookupTables, or any transaction data. To get executable swap data, use NewSwapQuoteStream or the Gateway Quote Swap endpoint.

Example

import WebSocket from 'ws';
// highlight-next-line
import { Encoder, Decoder } from '@msgpack/msgpack';
import { compressSync, decompressSync } from 'fflate';       // zstd-compatible deflate
import bs58 from 'bs58';

// --- Encoder / Decoder with BigInt support for u64 fields ---
// highlight-start
const encoder = new Encoder({ useBigInt64: true });
const decoder = new Decoder({ useBigInt64: true });
// highlight-end

// Connect with zstd sub-protocol for compressed frames
const url = `${process.env.TITAN_ENDPOINT}?auth=${process.env.TITAN_API_KEY}`;
// highlight-next-line
const ws = new WebSocket(url, ['v1.api.titan.ag+zstd', 'v1.api.titan.ag']);

let requestId = 0;

// Pubkeys as 32-byte binary — MessagePack sends these as raw bytes
const SOL  = bs58.decode('So11111111111111111111111111111111111111112');
const USDC = bs58.decode('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v');

/** Encode, optionally compress, and send a request frame. */
function sendRequest(ws: WebSocket, id: number, data: Record<string, unknown>) {
  // highlight-next-line
  const payload = encoder.encode({ id, data });

  // If the server negotiated the +zstd sub-protocol, compress before sending
  const frame =
    ws.protocol === 'v1.api.titan.ag+zstd'
      ? compressSync(new Uint8Array(payload))
      : payload;

  ws.send(frame);
}

/** Decompress (if needed) and decode an incoming frame. */
function decodeMessage(raw: Buffer): any {
  const bytes =
    ws.protocol === 'v1.api.titan.ag+zstd'
      ? decompressSync(new Uint8Array(raw))
      : raw;

  // highlight-next-line
  return decoder.decode(bytes);
}

ws.on('open', () => {
  // Request a price-only quote — no transaction data returned
  sendRequest(ws, requestId++, {
    GetSwapPrice: {
      inputMint: SOL,
      outputMint: USDC,
      amount: 1_000_000_000n, // 1 SOL in lamports
    },
  });
});

ws.on('message', async (raw: Buffer) => {
  const msg = decodeMessage(raw);

  // highlight-start
  // Price response — use amountOut for display
  if ('Response' in msg && 'GetSwapPrice' in msg.Response.data) {
    const price = msg.Response.data.GetSwapPrice;
    console.log('Output amount:', price.amountOut);   // BigInt
    ws.close();
  }
  // highlight-end

  if ('Error' in msg) {
    console.error(`Error ${msg.Error.code}: ${msg.Error.message}`);
    ws.close();
  }
});

See Connection & Negotiation for sendRequest and decodeMessage setup.

---

Related pages

• NewSwapQuoteStream — full quote with executable instructions

• Gateway Quote Price — REST equivalent

• Configure Routing — venue filtering with dexes and excludeDexes