Info / Venues / Providers

Server info, venues, and providers via REST.

Three lightweight endpoints for reading server configuration and discovering available venues and providers. All are simple GET requests you can issue at any time.

All responses are MessagePack-encoded. Set Accept: application/vnd.msgpack in your request headers.

Authentication — Authorization: Bearer <token> header or ?auth=<token> query param. See Connection & Negotiation for JWT details.

---

Info

GET /api/v1/info

Returns server settings, protocol version, and configurable parameter bounds. The REST equivalent of GetInfo. Call it to read the defaults and limits you'll need when configuring swap requests.

For full ServerInfo type definitions (including VersionInfo, ServerSettings, BoundedValueWithDefault, and all sub-types), see the GetInfo reference page.

Example

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

// useBigInt64 required — 64-bit integer fields (amounts, timestamps)
const decoder = new Decoder({ useBigInt64: true });

// Fetch server info from the Gateway REST endpoint
const res = await fetch(
  `${process.env.TITAN_ENDPOINT}/api/v1/info`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.TITAN_API_KEY}`,
      'Accept': 'application/vnd.msgpack',
    },
  }
);

// Decode the MessagePack response
const info = decoder.decode(new Uint8Array(await res.arrayBuffer())) as any;

// Protocol version — major changes are backwards-incompatible
console.log('Protocol version:', info.protocolVersion);

// Quote stream settings — use these bounds when configuring requests
console.log('Default update interval:', info.settings.quoteUpdate.intervalMs.default, 'ms');
console.log('Concurrent streams allowed:', info.settings.connection.concurrentStreams);

---

Venues

GET /api/v1/venues

Returns the list of on-chain venues available for routing. Each label is a valid value for the dexes and excludeDexes query parameters on Quote Swap and Quote Price.

For full VenueInfo type definitions, see the GetVenues / ListProviders reference page.

Query parameters

• includeProgramIds — "true" to include the Solana program ID for each venue.

Example

// Fetch all available venues with their on-chain program IDs
const res = await fetch(
  `${process.env.TITAN_ENDPOINT}/api/v1/venues?includeProgramIds=true`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.TITAN_API_KEY}`,
      'Accept': 'application/vnd.msgpack',
    },
  }
);

// Decode and inspect the venue list
const venues = decoder.decode(new Uint8Array(await res.arrayBuffer())) as any;
console.log('Available venues:', venues.labels);
// e.g. ['Raydium', 'Whirlpool', 'Phoenix', 'Meteora', ...]

---

Providers

GET /api/v1/providers

Returns the list of active quote providers. Each id is a valid value for the providers query parameter on Quote Swap. Each provider independently competes to deliver the best-priced route.

For full ProviderInfo and ProviderKind type definitions, see the GetVenues / ListProviders reference page.

Query parameters

• includeIcons — "true" to include 48×48 icon URIs for each provider.

Example

// Fetch all active quote providers
const res = await fetch(
  `${process.env.TITAN_ENDPOINT}/api/v1/providers`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.TITAN_API_KEY}`,
      'Accept': 'application/vnd.msgpack',
    },
  }
);

// Decode and iterate over the provider list
const providers = decoder.decode(new Uint8Array(await res.arrayBuffer())) as any[];
for (const p of providers) {
  console.log(`${p.name} (${p.id}) — ${p.kind}`);
  // e.g. "Titan (Titan) — DexAggregator"
}

---

Error responses

• 400 — Invalid parameters. Malformed query parameter value.

• 401 — Missing or invalid authentication token. Check your JWT and its claims.

---

Related pages

• GetInfo — Direct (WebSocket) equivalent with full ServerInfo type definitions

• GetVenues / ListProviders — Direct (WebSocket) equivalents with full VenueInfo and ProviderInfo type definitions

• Configure Routing — Use venue and provider IDs to filter and customize quote routing

• Titan Direct vs Titan Gateway — Choosing between WebSocket and REST