sdk documentation

ParasolDEX SDK

Everything you need to integrate ParasolDEX into your agent or application. TypeScript and Python SDKs with full x402 auto-pay and MPC wallet support.

The ParasolDEX SDK powers all swap operations. Point it at api.parasol.so and you're set.

import { MoltyDEXClient } from 'moltydex';

const client = new MoltyDEXClient('https://api.parasol.so');

// get a swap quote
const quote = await client.getQuote(
  'So11111111111111111111111111111111111111112',   // SOL
  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
  '100000000', // 0.1 SOL in lamports
);

console.log(`output: ${quote.output_after_fee} USDC`);

import { X402AutoPayAgent } from 'moltydex';

const agent = new X402AutoPayAgent({
  apiUrl: 'https://api.parasol.so',
  walletPath: './wallet.json',
  autoSwap: true,
});

console.log(`agent wallet: ${agent.getWalletAddress()}`);

// when you get a 402 Payment Required response:
const result = await agent.handle402(paymentResponseBody);

if (result.success) {
  console.log(`paid. signature: ${result.payment_signature}`);
}

from moltydex import MoltyDEX

dex = MoltyDEX(
    api_url="https://api.parasol.so",
    wallet_path="~/.config/solana/id.json",
)

quote = dex.quote(
    token_in="So11111111111111111111111111111111111111112",
    token_out="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    amount_in=100_000_000,
)
print(f"output: {quote['output_after_fee']} USDC")

result = dex.swap(
    token_in="So11111111111111111111111111111111111111112",
    token_out="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    amount_in=100_000_000,
    wait_for_confirmation=True,
)
print(f"swap signature: {result['signature']}")

# when your agent gets a 402 response:
result = dex.handle_x402_payment(payment_402_response_body)

if result['ready']:
    print("payment ready — sufficient balance")
else:
    print(f"swap completed: {result['swap_result']['signature']}")

# or use one-call auto-pay:
result = dex.x402_auto_pay(
    payment_response_body=response_402_body,
    auto_swap=True,
)

import { HTTPInterceptor } from 'moltydex';

const interceptor = new HTTPInterceptor({
  apiUrl: 'https://api.parasol.so',
  walletPath: './wallet.json',
  autoSwap: true,
});

// all fetch() calls now auto-handle 402 Payment Required
const response = await fetch('https://some-x402-api.com/data');
// if it returns 402, the agent pays automatically and retries

// restore original fetch when done
interceptor.restore();

import { MoltyDEXClient } from 'moltydex';

const client = new MoltyDEXClient('https://api.parasol.so');

// parse a 402 response body
const requirements = await client.parsePayment(response402Body);

// one-call auto-pay: checks balance, swaps if needed, pays
const result = await client.autoPay(
  response402Body,
  walletAddress,
  'So11111111111111111111111111111111111111112', // pay from SOL
  true, // autoSwap
);

interface TransactionSigner {
  getAddress(): string;
  signTransaction(transactionBase64: string): Promise<string>;
}

import { X402AutoPayAgent } from 'moltydex';

const agent = new X402AutoPayAgent({
  apiUrl: 'https://api.parasol.so',
  turnkeyApiKey: 'your-turnkey-key',
  createWallet: true,
  autoSwap: true,
});

// agent now has its own wallet — no private key needed
console.log('agent wallet:', agent.getAddress());