Quickstart

curl https://api.ternswap.xyz/v1/quote \
  -H "content-type: application/json" \
  -d '{
    "from": { "chain": "base", "asset": "native", "amount": "1000000000000000" },
    "to":   { "chain": "base", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" }
  }'

{
  "route": "swap",
  "from": { "chain": "base", "asset": "native", "amount": "1000000000000000", "usd": "2.04" },
  "to":   { "chain": "base", "asset": "0x8335…2913", "amount": "2048221", "minAmount": "2037979", "usd": "2.04" },
  "fees": { "totalUsd": "0.01", "items": [ { "kind": "protocol", "usd": "0.00" }, { "kind": "network", "usd": "0.01" } ] },
  "etaSecs": 8,
  "expiresAt": 1794406566
}

import { createWalletClient, http, publicActions } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const API = "https://api.ternswap.xyz";
const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const wallet = createWalletClient({ account, chain: base, transport: http() }).extend(publicActions);

const quote = await fetch(`${API}/v1/quote`, {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    from: { chain: "base", asset: "native", amount: "1000000000000000" },
    to: { chain: "base", asset: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" },
    sender: account.address,
    recipient: account.address,
  }),
}).then((res) => res.json());

for (const tx of quote.execute.transactions) {
  const hash = await wallet.sendTransaction({ to: tx.to, data: tx.data, value: BigInt(tx.value) });
  await wallet.waitForTransactionReceipt({ hash });
}

let status;
do {
  await new Promise((resolve) => setTimeout(resolve, 3000));
  status = await fetch(`${API}/v1/quote/${quote.id}`).then((res) => res.json());
} while (!["completed", "refunded", "expired"].includes(status.status));

console.log(status.status, status.destination.amount);