orca

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

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

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. ## 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 & Discovery: Create Splash pools or concentrated liquidity pools with correct tick spacing, and fetch pool/position data by owner or token pair. - 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 using the new SDK with 1% slippage tolerance.

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.

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. They are not compatible, so pick based on your project's Solana library version.

How do I open a concentrated liquidity position on Orca?

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

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. Only these four values are valid.

Why does my Orca swap fail with SlippageExceeded?

The price moved beyond your slippage tolerance before the transaction confirmed. Increase the slippage 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.