Connect

GammaSwap provides separate endpoints for HTTP requests, market updates, oracle prices, and on-chain deposit operations.

Service URLs

Service	Production URL	Used by
Exchange HTTP API	https://exchange-api.gammaswap.com/api	InfoClient, ExchangeClient
Market WebSocket	wss://exchange-api.gammaswap.com/ws/	ExchangeWebSocketClient
Oracle WebSocket	wss://exchange-api.gammaswap.com/oracle-ws/	OracleWebSocketClient
Chain RPC	Your RPC provider URL	DepositClient

Local service defaults:

Service	Local URL
Exchange HTTP API	http://localhost:3000
Market WebSocket	ws://127.0.0.1:4000
Oracle WebSocket	ws://127.0.0.1:8082

Production HTTP requests use the /api base path. Local deployments are normally served without an /api prefix.

Environment configuration

A server-side application can store connection settings in environment variables:

EXCHANGE_API_URL=https://exchange-api.gammaswap.com/api
MARKET_WS_URL=wss://exchange-api.gammaswap.com/ws/
ORACLE_WS_URL=wss://exchange-api.gammaswap.com/oracle-ws/

CHAIN_ID=84532
RPC_URL=https://your-rpc-provider.example
PRIVATE_KEY=0x...

Do not expose PRIVATE_KEY in frontend code, public environment variables, logs, or source control.

Connect to the HTTP API

Read-only requests use InfoClient.

import { createInfoClient } from "@gammaswap/v2-exchange-sdk";

const info = createInfoClient({
  apiUrl: process.env.EXCHANGE_API_URL!,
});

Signed exchange actions use ExchangeClient.

import { createExchangeClient } from "@gammaswap/v2-exchange-sdk";
import { Wallet } from "ethers";

const wallet = new Wallet(process.env.PRIVATE_KEY!);

const exchange = createExchangeClient({
  apiUrl: process.env.EXCHANGE_API_URL!,
  wallet,
  chainId: process.env.CHAIN_ID!,
});

Connect to the market WebSocket

import {
  createExchangeWebSocketClient,
} from "@gammaswap/v2-exchange-sdk";

const marketStream = createExchangeWebSocketClient({
  websocketUrl: process.env.MARKET_WS_URL!,
  onError: (error) => console.error("Market stream error", error),
});

await marketStream.connect();

Calling connect() is optional before subscribing. Subscription methods establish the connection when necessary.

Connect to the oracle WebSocket

import {
  createOracleWebSocketClient,
} from "@gammaswap/v2-exchange-sdk";

const oracleStream = createOracleWebSocketClient({
  websocketUrl: process.env.ORACLE_WS_URL!,
  onError: (error) => console.error("Oracle stream error", error),
});

await oracleStream.connect();

Connect to the chain

DepositClient connects to an EVM JSON-RPC provider.

import { createDepositClient } from "@gammaswap/v2-exchange-sdk";
import { Wallet } from "ethers";

const wallet = new Wallet(process.env.PRIVATE_KEY!);

const deposit = createDepositClient({
  rpcUrl: process.env.RPC_URL!,
  wallet,
  chainId: process.env.CHAIN_ID!,
});

The client verifies that the RPC network matches the configured chainId before performing contract reads or transactions.

Chain IDs and contracts

The supplied SDK examples use Base Sepolia:

Network	Chain ID
Base Sepolia	84532

When the SDK includes default contract addresses for a chain, it resolves those contracts automatically.

For a custom or unsupported deployment, provide contract overrides:

const exchange = createExchangeClient({
  apiUrl: process.env.EXCHANGE_API_URL!,
  wallet,
  chainId: process.env.CHAIN_ID!,
  contracts: {
    // Exchange contract overrides
  },
});

For deposits, the deposit-ledger address can be supplied directly:

const deposit = createDepositClient({
  rpcUrl: process.env.RPC_URL!,
  wallet,
  chainId: process.env.CHAIN_ID!,
  depositLedger: "0x...",
});

The production chain ID and production RPC provider are not specified in the supplied developer documentation.