Configure Routing

Control which venues, providers, and route shapes Titan uses when computing swap quotes.

Titan routes through Argos across all available venues and providers by default. You can restrict or filter routing using the parameters below — all go into the swap or transaction object of your request.

Routing parameters

These fields are part of SwapParams:

• dexes (string[]) — Only route through these venues. Venues are on-chain liquidity sources — Raydium, Phoenix, Meteora, Orca, Whirlpool, PumpFun, and others.

• excludeDexes (string[]) — Exclude these venues from routing. All other venues remain available.

• venueAllowlist (Pubkey[]) — Constrain quotes to routes that only use venues (pools) whose address is in this list. Filters by individual venue address, unlike dexes/excludeDexes which filter by venue label.

• venueBanlist (Pubkey[]) — Exclude any route that uses a venue (pool) whose address is in this list. The banlist overrides venueAllowlist — a venue in both lists is always excluded.

• noVoteAccounts (bool) — Exclude a server-configured set of market-maker venues from routing. When absent or false, those venues are included as normal.

• providers (string[]) — Only use these quote providers. Providers are the quote sources that compete to give you the best price — Titan, Metis, Okx, and others.

• onlyDirectRoutes (bool) — Skip multi-hop routes. Useful when you want predictable gas costs or need to avoid complex route topologies.

• addSizeConstraint (bool) — If true, only quotes with transactions that fit within the size constraint are returned.

• sizeConstraint (u32) — Maximum transaction size in bytes when addSizeConstraint is set. Values are clamped to the requested format's maximum: 1232 bytes for V0 and 4096 bytes for V1.

• accountsLimitTotal (u16) — Max total accounts per route. Transaction V1 supports at most 64 addresses; higher values are clamped.

• accountsLimitWritable (u16) — Max writable accounts per route. If not set, any number that still allows an executable transaction is allowed (currently 64).

The transaction format is selected with transaction.transactionFormat: 0 for V0 (the default) or 1 for Transaction V1. See NewSwapQuoteStream → Transaction format for compatibility and activation requirements.

Providers and venues are independent filters. Providers decide who computes the route; venues decide where liquidity is sourced. You can combine both.

Example: combining multiple filters

Titan Direct

import WebSocket from 'ws';
import { Encoder } from '@msgpack/msgpack';
import bs58 from 'bs58';
import { zstdCompress } from 'http-encoding';

const encoder = new Encoder({ useBigInt64: true });

const url = `${process.env.TITAN_ENDPOINT}?auth=${process.env.TITAN_JWT}`;
const ws = new WebSocket(url, [
  'v1.api.titan.ag+zstd',
  'v1.api.titan.ag',
]);

let useCompression = false;
let requestId = 0;

ws.on('open', async () => {
  useCompression = ws.protocol !== 'v1.api.titan.ag';

  const encoded = encoder.encode({
    id: requestId++,
    data: {
      NewSwapQuoteStream: {
        swap: {
          inputMint: bs58.decode('So11111111111111111111111111111111111111112'),
          outputMint: bs58.decode('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'),
          amount: 1_000_000_000n,
          slippageBps: 50,
          dexes: ['Raydium', 'Whirlpool', 'Phoenix'],  // Only these venues
          providers: ['Titan', 'Metis'],                 // Only these providers
          onlyDirectRoutes: true,                        // No multi-hop
          addSizeConstraint: true,
          accountsLimitTotal: 40,
        },
        transaction: {
          userPublicKey: bs58.decode('YOUR_WALLET_PUBLIC_KEY'),
        },
      },
    },
  });
  ws.send(useCompression ? await zstdCompress(encoded) : encoded);
});

Titan Gateway

import { decode } from '@msgpack/msgpack';

const params = new URLSearchParams({
  inputMint: 'So11111111111111111111111111111111111111112',
  outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
  amount: '1000000000',
  userPublicKey: 'YOUR_WALLET_PUBLIC_KEY',
  slippageBps: '50',
  dexes: 'Raydium,Whirlpool,Phoenix',
  providers: 'Titan,Metis',
  onlyDirectRoutes: 'true',
  addSizeConstraint: 'true',
  accountsLimitTotal: '40',
});

const res = await fetch(
  `${process.env.TITAN_ENDPOINT}/api/v1/quote/swap?${params}`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.TITAN_JWT}`,
      'Accept': 'application/vnd.msgpack',
    },
  }
);

const buffer = await res.arrayBuffer();
const quotes = decode(new Uint8Array(buffer)) as any;

List available venues and providers

Query the server at runtime to discover which venues and providers are currently active.

Titan Direct

// List all venues with their program IDs
sendRequest({ GetVenues: { includeProgramIds: true } });

// List all active providers
sendRequest({ ListProviders: {} });

Titan Gateway

import { decode } from '@msgpack/msgpack';

const venuesRes = await fetch(
  `${process.env.TITAN_ENDPOINT}/api/v1/venues?includeProgramIds=true`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.TITAN_JWT}`,
      'Accept': 'application/vnd.msgpack',
    },
  }
);
const venues = decode(new Uint8Array(await venuesRes.arrayBuffer())) as any;
console.log('Available venues:', venues.labels);

const providersRes = await fetch(
  `${process.env.TITAN_ENDPOINT}/api/v1/providers`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.TITAN_JWT}`,
      'Accept': 'application/vnd.msgpack',
    },
  }
);
const providers = decode(new Uint8Array(await providersRes.arrayBuffer())) as any[];
console.log('Active providers:', providers.map((p: any) => p.id));

Related pages

• Stream & Execute a Swap — full guide with transaction building and error handling

• Fee Collection — add platform fees to swap transactions

• Types Reference — SwapParams, TransactionParams, and all type definitions

• GetVenues / ListProviders Reference — complete response schemas