orca

Build swaps, liquidity positions, and pools on Orca Whirlpools using the TypeScript SDK.

6|20|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/andresdefi/cryptoskills --skill orca-andresdefi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orca
Source: https://github.com/andresdefi/cryptoskills/tree/main/skills/orca
Command: npx skills add https://github.com/andresdefi/cryptoskills --skill orca-andresdefi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @orca-so/whirlpools, @solana/kit, @orca-so/whirlpools-sdk, @coral-xyz/anchor, @solana/web3.js.

What problem does it solve? AI agents and developers often have outdated or incorrect knowledge of the Orca Whirlpools SDK, leading to wrong program IDs, deprecated API calls, and failed Solana transactions. This Skill provides accurate, current guidance for building on Orca's concentrated liquidity AMM across Solana and Eclipse networks. ## Core Features & Use Cases - Token Swaps: Execute exact-input and exact-output swaps with slippage protection, quotes, and price impact estimates using the new @orca-so/whirlpools SDK or the legacy SDK. - Liquidity Position Management: Open concentrated or full-range positions, increase/decrease liquidity, harvest fees and rewards, and close positions programmatically. - Pool Creation & Data Fetching: Create splash pools and concentrated liquidity pools with correct tick spacing, and fetch pool/position state for monitoring. - Use Case: Build a bot that monitors your Whirlpools positions, detects when they go out of range, harvests accumulated fees above a USD threshold, and rebalances liquidity into a new price range. ## Quick Start Ask the agent to write a TypeScript script that swaps 1 SOL for USDC on the Orca SOL/USDC Whirlpool with 1% slippage using the new SDK.

Frequently Asked Questions about orca

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I swap tokens on Orca Whirlpools with TypeScript?

Use the swap or swapInstructions functions from @orca-so/whirlpools with an input or output amount, the pool address, and a slippage tolerance in basis points. The quote returns estimated output, minimum output, and price impact before execution.

How do I open a concentrated liquidity position on Orca?

Call openPositionInstructions with the pool address, a token or liquidity amount, and lower/upper price bounds. It returns the position mint, required token amounts, and a callback to send the transaction.

What is the difference between the new and legacy Orca Whirlpools SDK?

The new @orca-so/whirlpools SDK uses Solana Web3.js v2 with @solana/kit, while the legacy @orca-so/whirlpools-sdk uses Web3.js v1 with Anchor 0.29.0. The two are not compatible, so pick based on your project's Solana library version.

Which tick spacing should I use when creating an Orca pool?

Use tick spacing 1 (0.01% fee) for stablecoins, 8 (0.04%) for correlated pairs, 64 (0.30%) for standard pairs, and 128 (1.00%) for volatile or exotic pairs. Token mints must be ordered with the orderMints function before pool creation.

Why does my Orca swap fail with SlippageExceeded?

The price moved beyond your slippage tolerance before the transaction confirmed. Increase the slippage tolerance in basis points, split large swaps into smaller chunks, or configure dynamic priority fees so the transaction lands faster.

Does Orca Whirlpools work on networks other than Solana mainnet?

Yes, the SDK supports solanaMainnet, solanaDevnet, eclipseMainnet, and eclipseTestnet presets via setWhirlpoolsConfig. The Whirlpool program ID is the same across all four networks.