> For the complete documentation index, see [llms.txt](https://wayfinder-1.gitbook.io/wayfinder/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wayfinder-1.gitbook.io/wayfinder/readme.md).

# Wayfinder

One agent for all your crypto. Trade spot, perps, and prediction markets, manage positions across chains, run automated strategies, and schedule jobs that keep working while you sleep.

## Three ways in

### 1. Shells (start here)

Open the Wayfinder app and provision a Shell — your own agent in a sandboxed runtime, persistently running, transacting on your behalf within whatever permissions you set.

* Portfolio view with positions, P\&L, exposures, and TradingView charts
* Spot, perps, and prediction market trading from a single conversation
* Scheduled jobs for automation that runs even when you're away
* Non-custodial: wallets sign remotely, so the agent never holds your private keys
* Default model: Deepseek v4 (with Kimi K2.6 and GPT-4 options)

[Get started with Shells](/wayfinder/shells/app.md)

### 2. Paths (extend your agent)

Browse and install community-built plugins at [wayfinder.ai/app/paths](https://wayfinder.ai/app/paths). A Path can be a skill prompt, a dashboard applet, Python scripts, an autonomous strategy, live signals, or any combination. Creators bond $PROMPT to publish; the community stakes on quality.

[Explore Paths](/wayfinder/paths/paths.md)

### 3. SDK / CLI (advanced)

Clone the open-source SDK and run it in Claude Code, Codex, Opencode, or any MCP-compatible agent. Full programmatic access to every adapter, strategy, and MCP tool.

```bash
git clone https://github.com/WayfinderFoundation/wayfinder-paths-sdk
cd wayfinder-paths-sdk
# Open in your coding agent of choice
```

[SDK quickstart](/wayfinder/sdk-setup/quickstart.md)

## Example prompts

These work in the Wayfinder app or any agent connected to the Wayfinder SDK.

### What's in my wallet?

```
What's in my wallet?
```

Your agent reads balances across chains and gives you a multi-chain breakdown.

### Swap cross-chain

```
Swap 100 USDC on Arbitrum for PROMPT on Base.
First show me the quote, then ask for confirmation before executing.
```

### Check funding rates

```
Check the current ETH funding rate on Hyperliquid and tell me if it's positive or negative.
```

### Conditional multi-step trade

```
If ETH funding on Hyperliquid is positive:
1) Swap 100 USDC on Base into wstETH.
2) Short $100 notional ETH perp on Hyperliquid at 2x cross leverage.
Ask for confirmation before each fund-moving step.
```

## Get started

* [Provision a Shell](/wayfinder/shells/getting-started.md)
* [Browse Paths](/wayfinder/paths/paths.md)
* [SDK Quickstart](/wayfinder/sdk-setup/quickstart.md)
* [Architecture](/wayfinder/sdk-concepts/architecture.md)
* [Protocols](/wayfinder/protocols-and-adapters/protocols.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://wayfinder-1.gitbook.io/wayfinder/readme.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.