Quote Price

Get a price-only quote via REST without transaction data.

Returns a price quote without instructions or transaction data. Use it when you need to display prices without the overhead of building executable transactions. The Gateway equivalent of GetSwapPrice.

GET /api/v1/quote/price

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

---

Query parameters

Required

• inputMint — Input token mint address (base58).

• outputMint — Output token mint address (base58).

• amount — Amount in the smallest unit (e.g. lamports for SOL). Not scaled by decimals.

Routing options

• dexes — Comma-separated venue labels to include. See GetVenues for valid labels.

• excludeDexes — Comma-separated venue labels to exclude.

This endpoint does not accept userPublicKey, feeAccount, or any transaction-related parameters. To get executable swap data, use Quote Swap.

---

Response

The response body is MessagePack-encoded. Set Accept: application/vnd.msgpack in your request headers.

The response is a SwapPrice object — the same type returned by the Titan Direct GetSwapPrice RPC method. See GetSwapPrice for the full type definition.

---

Example

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

// useBigInt64 required — amounts are u64
const decoder = new Decoder({ useBigInt64: true });

// 1 SOL → USDC price check
const params = new URLSearchParams({
  inputMint: 'So11111111111111111111111111111111111111112',   // SOL
  outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
  amount: '1000000000', // 1 SOL in lamports
});

// Fetch price from Gateway
const res = await fetch(
  `${process.env.TITAN_ENDPOINT}/api/v1/quote/price?${params}`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.TITAN_API_KEY}`,
      'Accept': 'application/vnd.msgpack', // Required for MessagePack response
    },
  }
);

if (!res.ok) {
  throw new Error(`${res.status}: ${res.statusText}`);
}

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

console.log('Output amount:', price.amountOut);

---

Error responses

• 400 — Invalid parameters. Malformed pubkey, missing required field, or value out of bounds.

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

• 404 — No routes found for this swap pair. Try relaxing routing constraints.

---

Related pages

• Quote Swap — Full quote with executable transaction instructions, ready to sign and send

• GetSwapPrice — Direct (WebSocket) equivalent; returns the same SwapPrice type

• Configure Routing — Venue filtering strategies using dexes and excludeDexes