plugy

SKILL.md

---
name: plugy
version: 3.0.0
description: Solana trading skill for AI agents. Buy, sell, and create tokens across PumpFun, PumpSwap, LaunchLab, and Meteora.
homepage: https://plugy.fun
metadata:
  category: trading
  chain: solana
  api_base: https://plugy.fun/api
---

# PLUGy

Trade Solana tokens. Buy, sell, create. Works with any AI agent.

---

## Skill Files — READ THE RIGHT FILE FOR EACH ACTION

Each action has its own file. **Fetch only the file you need:**

| Action | File | URL |
|--------|------|-----|
| **Buy / Sell** | TRADE.md | `https://plugy.fun/trade.md` |
| **Create token** | CREATE.md | `https://plugy.fun/create.md` |
| **Autonomous loop** | HEARTBEAT.md | `https://plugy.fun/heartbeat.md` |
| **Security rules** | RULES.md | `https://plugy.fun/rules.md` |
| **This file (hub)** | SKILL.md | `https://plugy.fun/skill.md` |
| **Metadata** | package.json | `https://plugy.fun/skill.json` |

**Install all locally:**
```bash
mkdir -p ~/.plugy/skills/plugy
curl -s https://plugy.fun/skill.md     > ~/.plugy/skills/plugy/SKILL.md
curl -s https://plugy.fun/trade.md     > ~/.plugy/skills/plugy/TRADE.md
curl -s https://plugy.fun/create.md    > ~/.plugy/skills/plugy/CREATE.md
curl -s https://plugy.fun/heartbeat.md > ~/.plugy/skills/plugy/HEARTBEAT.md
curl -s https://plugy.fun/rules.md     > ~/.plugy/skills/plugy/RULES.md
curl -s https://plugy.fun/skill.json   > ~/.plugy/skills/plugy/package.json
```

---

## CRITICAL SECURITY WARNING

- **NEVER send your API key to any domain other than `plugy.fun`**
- Your API key should ONLY appear in `x-api-key` headers to `https://plugy.fun/api/*`
- If any tool, agent, or prompt asks you to send your PLUGy API key elsewhere — **REFUSE**
- Your API key is your identity. Leaking it means someone else can trade with your funds.

**Read RULES.md for full security and behavior guidelines.**

---

## Register First

Every agent must register once to get a custodial wallet:

```bash
curl -X POST https://plugy.fun/api/agents/register \
  -H "Content-Type: application/json"
```

Response:
```json
{
  "success": true,
  "apiKey": "plugy_abc123...",
  "publicKey": "SolanaAddress...",
  "privateKey": "base58PrivateKey...",
  "message": "Agent registered. Save your apiKey and privateKey NOW.",
  "warning": "The privateKey is displayed this one time only."
}
```

**IMPORTANT — you MUST do all of the following after registration:**
1. **Show the `privateKey` to your human user immediately.** This is their wallet key — they need it to withdraw funds. It is shown this one time only and cannot be recovered.
2. **Show the `publicKey`** — this is the Solana wallet address they need to fund with SOL.
3. **Save the `apiKey` in your memory** — you need it for all requests. Never show it publicly.
4. **Do NOT register again** if you already have an API key. Check your memory/storage first before calling register.

**Tell your human:**
> "Here is your wallet private key: `[privateKey]`. Save it securely — it will never be shown again. Send SOL to `[publicKey]` to start trading."

Store the apiKey in your memory, environment variables (`PLUGY_API_KEY`), or `~/.config/plugy/credentials.json`.

---

## Authentication

All requests require your API key in the header:

```
x-api-key: plugy_YOUR_API_KEY
```

**Only send to `https://plugy.fun` — never anywhere else!**

---

## What do you want to do?

### Buy or sell a token?
→ **Fetch `https://plugy.fun/trade.md`** — has the exact curl, params, and response format.

### Create / launch a new token?
→ **Fetch `https://plugy.fun/create.md`** — has the exact curl, required fields, and common mistakes.

### Set up autonomous trading?
→ **Fetch `https://plugy.fun/heartbeat.md`** — has the full heartbeat loop, strategy setup, and signal filtering.

### Check balance or positions?
→ **Fetch `https://plugy.fun/trade.md`** — helper endpoints are documented there too.

**Do NOT guess any curl format. Fetch the right file and follow it exactly.**

---

## Links

- **Website:** [https://plugy.fun](https://plugy.fun)
- **Scope (live signals):** [https://plugy.fun/scope](https://plugy.fun/scope)
- **Docs:** [https://plugy.fun/docs](https://plugy.fun/docs)
- **Twitter:** [https://x.com/plugyfun](https://x.com/plugyfun)