0x Solana Swap Example

This TypeScript project demonstrates how to interact with the 0x Swap API for Solana to get a quote, build swap instructions, and send a swap transaction.

Example Output

➜  0x-solana-example git:(main) ✗ npm run index

> 0x-solana-example@1.0.0 index
> tsx src/index.ts

💰 Quote received: 0.16 USDC
✅ Simulation succeeded
✍️ Transaction sent with signature: 3ofwWgzDzZRpPGNQTvAKSY4o3FMPT2y7fjCw6UtTAMTnvHj26TPaYVJWM88v28jNeey5CdX9sWGcVfPYfQNQsSBa
✅ Transaction confirmed: https://solscan.io/tx/3ofwWgzDzZRpPGNQTvAKSY4o3FMPT2y7fjCw6UtTAMTnvHj26TPaYVJWM88v28jNeey5CdX9sWGcVfPYfQNQsSBa

What It Does

This script performs the following steps:

1. Loads environment variables from .env (0x API key, private key, RPC URL).
2. Fetches a swap quote from the 0x /swap-instructions endpoint.

If you have provided a private key:

3. Builds and signs a transaction from the instructions.
4. Simulates the transaction to catch errors before sending.
5. If DRY_RUN=false, sends the transaction to the Solana blockchain to execute the swap.

Getting Started

1. Install Dependencies

npm install

2. Create a .env File

Copy the example from .env.example into a new .env file:

Variable Name	Description	Required	Default Value
ZEROEX_API_KEY	API Key for use with 0x Solana API.	✅	None
PRIVATE_KEY	Must be base58-encoded.	❌	Random generated
RPC_URL	Valid Solana RPC HTTP endpoint. For example, get a free RPC key and endpoint from Helius.	❌	https://api.mainnet-beta.solana.com
DRY_RUN	When true, fetches a quote and simulates but does not send the transaction.	❌	true

3. Run the Example

npm run index

📝 Notes

• The amount and token mint addresses are hardcoded for simplicity, but can be parameterized.
• amount_in is denominated in base units (e.g. 1 USDC = 1_000_000 units).