Quickstart

The whole flow is two calls: quote to get a pathId, then assemble to get a signable transaction. A pathId lives ~60 seconds. The examples below swap USDC for EURC. Any pair listed by GET /info/tokens/101 works the same way — swap the mints and nothing else changes.

Request a quote

curl -s https://api.astrolabe.markets/sor/quote/v3 \
  -H 'content-type: application/json' \
  -d '{
    "chainId": 101,
    "inputTokens": [{ "tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "amount": "1000000" }],
    "outputTokens": [{ "tokenAddress": "HzwqbKZw8HxMN6bF2yFZNrht3c2iXXzpKcFu7uBEDKtr", "proportion": 1 }],
    "userAddr": "<YOUR_WALLET>",
    "slippageLimitPercent": 0.3
  }'

The response carries outAmounts, an astrolabe.tier (which size tier priced it), and a pathId.

Assemble the transaction

curl -s https://api.astrolabe.markets/sor/assemble \
  -H 'content-type: application/json' \
  -d '{ "userAddr": "<YOUR_WALLET>", "pathId": "<pathId from step 1>", "simulate": true }'

transaction.data is a base64 VersionedTransaction.

Sign and submit

Decode transaction.data, sign as userAddr, and send it through any Solana RPC (Astrolabe uses FluxRPC, but any works). Astrolabe holds no keys.

JavaScript

const BASE = 'https://api.astrolabe.markets';
const USDC = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
const EURC = 'HzwqbKZw8HxMN6bF2yFZNrht3c2iXXzpKcFu7uBEDKtr';

const quote = await fetch(`${BASE}/sor/quote/v3`, {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    chainId: 101,
    inputTokens: [{ tokenAddress: USDC, amount: '1000000' }],
    outputTokens: [{ tokenAddress: EURC, proportion: 1 }],
    userAddr,
    slippageLimitPercent: 0.3,
  }),
}).then((r) => r.json());

const assembled = await fetch(`${BASE}/sor/assemble`, {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ userAddr, pathId: quote.pathId, simulate: true }),
}).then((r) => r.json());

// decode assembled.transaction.data -> sign -> send via your RPC

userAddr in assemble must match the one from quote. A mismatched or expired pathId returns 404.

Getting started

Concepts

JavaScript

​JavaScript

JavaScript