SDK

Haystack Router has SDKs to make integration as seamless as possible.

TypeScript / JavaScript

The @txnlab/haystack-router package wraps the API: it fetches quotes, builds the transaction group, and signs and submits it with any algosdk-compatible signer (e.g. use-wallet).

GitHub - TxnLab/haystack-js: TypeScript/JavaScript SDK for Haystack Order Router - smart order routing and DEX aggregation on AlgorandGitHub

Installation

npm install @txnlab/haystack-router algosdk

Requires algosdk 3.0.0 or later and Node.js 20 or later.

Quick start

import { RouterClient } from '@txnlab/haystack-router'
import { useWallet } from '@txnlab/use-wallet-react'

const { activeAddress, transactionSigner } = useWallet()

const router = new RouterClient({
  apiKey: '1b72df7e-1131-4449-8ce1-29b79dd3f51e', // Free tier (60 requests/min)
})

// Get a quote
const quote = await router.newQuote({
  fromASAID: 0, // ALGO
  toASAID: 31566704, // USDC
  amount: 1_000_000, // 1 ALGO
  address: activeAddress,
})

// Execute the swap
const swap = await router.newSwap({
  quote,
  address: activeAddress,
  signer: transactionSigner,
  slippage: 1, // 1%
})
const result = await swap.execute()

The repository includes example integrations for React, React with TanStack Query, and a Node.js CLI.

To obtain an API key with a higher rate limit, reach out to [e-mail].