> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# TypeScript — Overview

<Info>
  **Placing orders?** See [Trading](/sdks/ts/trading) for `PolyNodeTrader`, V2 order placement (`exchangeVersion: 'v2'`), builder attribution, and PolyUSD wrapping.
</Info>

## Install

```bash theme={null}
npm install polynode-sdk ws
```

Requires Node.js 18+. The `ws` package provides WebSocket support for Node.js.

## Quick Start

```typescript theme={null}
import { PolyNode } from 'polynode-sdk';

const pn = new PolyNode({ apiKey: 'pn_live_...' });

// Fetch top markets
const markets = await pn.markets({ count: 10 });
console.log(`${markets.count} markets, ${markets.total} total`);

// Search
const results = await pn.search('bitcoin');
console.log(results.results[0].question);
```

## V3 Quick Start

The original `pn.market`, `pn.wallet`, and other top-level methods keep their legacy behavior. Use `pn.v3` when you want the newer paginated historical data endpoints.

```typescript theme={null}
// Wallet P&L and enriched positions
const summary = await pn.v3.wallet('0xa9857c7bcb9bcfafd2c132ab053f34f678610058');
const positions = await pn.v3.walletPositions(summary.address, {
  status: 'open',
  sort: 'size',
  limit: 25,
});

// Builder-attributed fills
const trades = await pn.v3.builderTrades('0x4898df15ec6590495dc6c0fedf951ade3e64001d47f9caf44a64e86fc11959df', {
  marketSlug: 'dota2-tundra-xtreme-2026-05-22-game1',
  limit: 50,
});

// Resolve wallet identifiers
const resolved = await pn.resolve('alice123');
console.log(resolved.safe, resolved.eoa, resolved.username, resolved.type);
```