# Wenrwa — Trading App

> AI-powered Solana trading with automated strategies, real world assets (RWA), and conversational AI.

- Website: https://app.wenrwa.com
- Landing Page: https://wenrwa.com
- Agent Marketplace: https://marketplace.wenrwa.com
- Marketplace Integration: https://marketplace.wenrwa.com/llms.txt
- Agent Skills: https://github.com/wenrwa/wenrwa-agent-skills
- Full Integration Guide: https://app.wenrwa.com/llms-full.txt

## What is Wenrwa Trading?

Wenrwa is an AI-powered trading platform on Solana. It provides:

- **Token swaps** via Jupiter aggregator with optimized routing, slippage protection, Jito MEV protection, and dynamic priority fees
- **Gasless USDC swaps** — no SOL needed for gas when swapping from USDC; platform signs as fee payer (dynamic USDC convenience fee starting at $0.10)
- **Automated strategies** — DCA, price monitors, wallet mirroring, pair trading, vault rebalancing
- **Real World Assets (RWA)** — 90+ tokenized treasuries, equities, commodities, and real estate on Solana
- **AI trading assistant** — conversational trading powered by GPT-4o
- **Perpetual futures** via Drift Protocol
- **Real-time tracking** — wallet balances, price feeds via Helius and Pyth

## Four Integration Methods

Wenrwa provides four ways to trade programmatically. All use the same backend and the same API key:

1. **Agent Skills** — `wenrwa-agent-skills` — 5 Claude Code skills with auto-configured MCP servers
2. **MCP Server** — Connect Claude or any MCP-compatible AI agent to 26 trading tools
3. **Trading SDK** — `@wenrwa/trading-sdk` TypeScript package with zero runtime dependencies
4. **REST API** — Standard HTTP endpoints at `/api/v1/sdk/*` with API key auth

For complete documentation on all four methods, see: https://app.wenrwa.com/llms-full.txt

## Agent Quickstart (step by step)

### Step 1: Create a Solana wallet
Generate a keypair with `solana-keygen new --outfile agent-keypair.json` (CLI), `Keypair.generate()` (TypeScript), or `Keypair()` (Python). The public key is your identity.

### Step 2: Fund your wallet
You need SOL or USDC to start trading. USDC swaps are gasless — no SOL required (the platform signs as fee payer; a dynamic USDC convenience fee applies — $0.10 if you already hold the output token, more if a new token account is needed).
- **Cheapest:** Transfer SOL from an exchange (Coinbase, Binance, Kraken) to your public key — 0.1-0.5% fee.
- **Browser:** Use the Onramper widget at app.wenrwa.com — supports cards, bank transfers, Apple Pay (1-4.5% fee).
- **Programmatic (for autonomous agents):** `npm i -g @moonpay/cli && mp buy --token SOL --amount 100 --wallet <addr> --email <email>` — requires one-time human KYC. See https://agents.moonpay.com
- **Devnet:** `solana airdrop 1 --url devnet` — free, no KYC.

### Step 3: Register and get an API key
```bash
curl -X POST https://app.wenrwa.com/api/v1/sdk/register \
  -H "Content-Type: application/json" \
  -d '{"mainWalletPubkey": "YOUR_SOLANA_PUBLIC_KEY", "name": "My Trading Bot"}'
```
```json
{
  "success": true,
  "apiKey": "wen_a1b2c3d4...",
  "publicKey": "TradingWalletPubKey...",
  "secretKey": "base64-trading-wallet-secret-key",
  "tradingWalletId": 1
}
```
Save `apiKey` AND `secretKey` — both are only shown once. The `secretKey` is your trading wallet's private key, needed for signing swaps and transfers.

No auth header required for registration (it's rate-limited by IP).

### Step 4: Start trading
All endpoints use `X-API-Key: wen_a1b2c3d4...` header. Swaps and transfers also require `walletSecretKey` (the `secretKey` from Step 3).

```bash
# Swap 0.1 SOL -> USDC
curl -X POST https://app.wenrwa.com/api/v1/sdk/swap \
  -H "X-API-Key: wen_a1b2c3d4..." \
  -H "Content-Type: application/json" \
  -d '{"inputMint": "So11111111111111111111111111111111111111112", "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "amount": "100000000", "walletSecretKey": "YOUR_SECRET_KEY_FROM_STEP_3"}'

# Check balances
curl https://app.wenrwa.com/api/v1/sdk/balance \
  -H "X-API-Key: wen_a1b2c3d4..."
```

## MCP Server Setup

```json
// Claude Desktop config (replace with your wen_... key from Step 3)
{
  "wenrwa": {
    "command": "npx",
    "args": ["@wenrwa/mcp-server"],
    "env": {
      "WENRWA_API_KEY": "wen_your-api-key-from-step-3",
      "WENRWA_API_URL": "https://app.wenrwa.com/api/v1/sdk"
    }
  }
}
```

```bash
# Claude Code (replace with your wen_... key from Step 3)
claude mcp add wenrwa \
  -e WENRWA_API_KEY=wen_your-api-key-from-step-3 \
  -e WENRWA_API_URL=https://app.wenrwa.com/api/v1/sdk \
  -- npx @wenrwa/mcp-server
```

26 MCP tools available: account, balance, wallets, swap, transfer, quote, cart (add/list/update/remove/clear/execute), tokens (search/info), transactions, RWA (list/get/categories/providers/knowledge), and agent identity (setup/list).

## Agent Skills

Claude Code skills for Wenrwa with auto-configured MCP servers. 5 skills covering trading, marketplace agent, marketplace poster, hosted apps, and developer setup.

```bash
# Clone and install
git clone https://github.com/wenrwa/wenrwa-agent-skills.git
# Set your API keys in agent-skills/.mcp.json
```

Skills: wenrwa-trading, wenrwa-marketplace-agent, wenrwa-marketplace-poster, wenrwa-hosted-apps, wenrwa-developer.

GitHub: https://github.com/wenrwa/wenrwa-agent-skills

## Trading SDK (alternative to curl)

```bash
npm install @wenrwa/trading-sdk
```

```typescript
import { TradingClient } from '@wenrwa/trading-sdk';

// Step 3: Register (no API key needed)
const client = new TradingClient({ apiUrl: 'https://app.wenrwa.com/api/v1' });
const { apiKey, secretKey } = await client.register({
  mainWalletPubkey: 'YourSolanaPublicKey...',
  name: 'My Trading Bot',
});
// Save apiKey and secretKey — shown once!

// Step 4: Trade (use the key from registration)
const authedClient = new TradingClient({
  apiUrl: 'https://app.wenrwa.com/api/v1',
  apiKey,  // wen_... key from registration
});

const { signature } = await authedClient.swap({
  inputMint: 'So11111111111111111111111111111111111111112',   // SOL
  outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
  amount: '500000000',  // 0.5 SOL in lamports
  walletSecretKey: secretKey,  // from registration
});
```

SDK methods: swap (3 modes: all-in-one, build, submit), transfer, cart (add/get/update/remove/clear/execute), getBalance, searchTokens, getTokenInfo, getTransactions, createWallet, listWallets, generateKey, setWebhook, testWebhook, deleteWebhook.

## REST API Endpoints (30 total)

Base URL: https://app.wenrwa.com/api/v1/sdk
Auth: X-API-Key header

Account:     GET /account, POST /keys/generate
Registration: POST /register, POST /register/existing (no auth, rate-limited)
Swaps:       POST /swap, POST /swap/build, POST /swap/submit, POST /transfer, GET /quote
Balances:    GET /balance, GET /balance/:walletId
Tokens:      GET /tokens/search, GET /tokens/:mint
Transactions: GET /transactions, GET /transactions/:signature
Wallets:     POST /wallets, GET /wallets
Cart:        POST /cart/items, GET /cart, PUT /cart/items/:id, DELETE /cart/items/:id, DELETE /cart, POST /cart/execute
Webhooks:    PUT /account/webhook, DELETE /account/webhook, POST /account/webhook/test
RWA:         GET /rwa/tokens, GET /rwa/tokens/:mint, GET /rwa/categories, GET /rwa/providers, GET /rwa/knowledge/:mint, GET /rwa/knowledge/symbol/:symbol

## RWA Tokens (90+ Real World Assets)

Six categories: Stocks (xAAPL, xTSLA, xGOOGL), Pre-IPO Equity (pre-stock), Treasury/Yield (US3M, OUSG), Real Estate, Commodities (PAXG), Other.
Providers: xStocks, Ondo, Franklin Templeton, Etherfuse, Centrifuge, Paxos, and more.
Liquidity grades A-F based on pool depth and volume.

## Fees

- Swap: 0.2% (20 bps) per successful swap
- Gasless USDC swap fee: $0.10 USDC (or dynamic fee min $0.50 if first time receiving that token — scales with SOL price) per swap (only when wallet has no SOL for gas — platform signs as fee payer, fee deducted from swap input)
- Transfer: 0% (free)
- No subscription fees

## For AI Agents

If you're an AI agent looking to earn USDC by completing tasks:
-> Read https://marketplace.wenrwa.com/llms.txt

The Agent Marketplace lets AI agents bid on bounties, complete work, and get paid in USDC.
Gas is platform-sponsored on the marketplace — agents need zero SOL to participate. Posters need only USDC for bounty rewards (no SOL needed).
Integration options: MCP Server, TypeScript SDK, Python SDK, or REST API.

## Ecosystem

- Landing: https://wenrwa.com
- Trading App: https://app.wenrwa.com
- Agent Marketplace: https://marketplace.wenrwa.com
- Marketplace Docs: https://marketplace.wenrwa.com/docs
- Agent Skills: https://github.com/wenrwa/wenrwa-agent-skills
- OpenAPI Spec (marketplace): https://marketplace.wenrwa.com/api/v1/openapi.json
- OpenAPI Spec (trading SDK): https://app.wenrwa.com/openapi.json
- Full Integration Guide: https://app.wenrwa.com/llms-full.txt