# Getting started

***

description: Getting started with the Vertigo SDK v2

## Getting started

### Installation

To install the Vertigo SDK v2, use your preferred package installer:

```bash
npm install @vertigo-amm/vertigo-sdk
# or
yarn add @vertigo-amm/vertigo-sdk
bun install @vertigo-amm/vertigo-sdk
```

### Dependencies

Make sure you have the following dependencies installed:

* `@coral-xyz/anchor`
* `@solana/web3.js`
* `@solana/spl-token` Install them with: npm install @coral-xyz/anchor @solana/web3.js @solana/spl-token

### Basic setup

#### Read-only mode (no wallet required)

```typescript
import { Vertigo } from "@vertigo-amm/vertigo-sdk";
import { Connection } from "@solana/web3.js";
// Connect to Solana
const connection = new Connection("https://api.devnet.solana.com", "confirmed");
// Initialize Vertigo SDK in read-only mode
const vertigo = await Vertigo.loadReadOnly(connection, "devnet");
console.log("Vertigo SDK initialized (read-only)");
// Get pool data, quotes, etc.
const pools = await vertigo.pools.getPools();
### With wallet (full features)
import { Connection, Keypair } from "@solana/web3.js";
import * as anchor from "@coral-xyz/anchor";
// Load a wallet from a local file, or however you want to load a wallet
const walletKeypair = anchor.Wallet.local();
// Initialize Vertigo SDK with wallet
const vertigo = await Vertigo.load({
  connection,
  wallet: walletKeypair,
  network: "devnet",
});
console.log("Vertigo SDK initialized");
// Execute swaps, create pools, etc.
## Where to go from here
The next few pages cover basic interactions with Vertigo pools such as [**swapping tokens**](buy-tokens.md), and [**claiming**](claim-royalty-fees.md) royalties. If you plan to launch tokens, it is recommended to take a look at [**Token Factories**](token-factories.md), and explore [**customizing token factories**](../designing-token-factories.md).
## SDK v2 Architecture
The v2 SDK is organized into specialized client modules:
### Core Clients

**Swap Client** (`vertigo.swap`)
* `getQuote()` - Get swap quotes with slippage calculation
* `buy()` - Buy tokens (spend quote token like SOL, receive base token)
* `sell()` - Sell tokens (spend base token, receive quote token like SOL)
* `simulateSwap()` - Simulate swaps before executing
* `buildBuyTransaction()` - Build buy transactions manually
* `buildSellTransaction()` - Build sell transactions manually
**Pool Client** (`vertigo.pools`)
* `getPool()` - Fetch pool data from chain
* `getPools()` - Fetch multiple pools
* `findPoolsByMints()` - Find pools by token pair
* `getPoolAddress()` - Get pool PDA address
* `createPool()` - Create new liquidity pools
* `claimFees()` - Claim accumulated royalty fees
* `getPoolStats()` - Get pool statistics
**Pool Authority Client** (`vertigo.poolAuthority`)
* Advanced pool management for authorized users
* Create pools with custom configurations
**API Client** (`vertigo.api`)
* `getPoolStats()` - Get pool statistics and analytics
* `getTrendingPools()` - Get trending pools by timeframe
* `getTokenInfo()` - Get token metadata and info
* `subscribeToPool()` - Real-time pool updates via WebSocket
### Utility Functions
The SDK includes rich utilities for common operations:
import {
  formatTokenAmount,
  parseTokenAmount,
  getOrCreateATA,
  estimatePriorityFee,
  retry,
  getExplorerUrl,
  sendTransactionWithRetry,
} from "@vertigo-amm/vertigo-sdk";
## Migrating from v1
If you're upgrading from SDK v1, the legacy `VertigoSDK` class is still available for backwards compatibility:
import { VertigoSDK } from "@vertigo-amm/vertigo-sdk";
const provider = new anchor.AnchorProvider(connection, wallet);
const sdk = new VertigoSDK(provider);
However, we **strongly recommend** migrating to the new `Vertigo` client for:
- 50% less code on average
- Better performance and type safety
- Powerful new features (simulation, API client, utilities)
- Cleaner, more intuitive APIs
See the [**Migration Guide**](migration-guide.md) for complete step-by-step instructions, code comparisons, and a migration checklist.
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vertigo.sh/sdk-v2/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.