Agent Skills Plugin

The UpsideMAX skills plugin is an open-source bundle that teaches an AI coding assistant — Claude Code, Codex, or Cursor — how to drive UpsideMAX for you. Ask in plain language (“let me try it”, “buy BTC”, “show my positions”, “stream trades”) and the assistant runs the real, signed API calls against Devnet. It’s the fastest way to experience the exchange without writing any code first.

Everything runs on Devnet (https://dev.upsidemax.xyz). Wallets are generated at runtime and funded by the auto-airdrop — no real funds, no Mainnet risk, nothing to configure.

upsidemax/upside-agent-skills

Open-source. Clone it, read the code, or contribute. MIT licensed.

What’s in the plugin

Five skills. Start with upside-test — it’s the guided, one-command experience layer over the others.

Skill	What it does
`upside-test`	Start here. Try the whole product in single commands — register, trade, positions, live market — with zero setup.
`upside-onboarding`	Create an account, receive the test airdrop, verify balances.
`upside-trading`	Market data, place / modify / cancel orders, leverage.
`upside-websocket`	Subscribe to live order book, trades, candles, and account streams.
`upside-advanced`	Agent-wallet delegation, TP/SL, and decoding numeric error codes.

Install & start

Two steps in every tab: install from the repo, then the one line that starts the experience. All tabs install the same SKILL.md files — pick yours.

Claude Code
Codex
Cursor

1. Install — in an open Claude Code session:

/plugin marketplace add upsidemax/upside-agent-skills
/plugin install upside-agent-skills@upside-agent-skills
/reload-plugins

2. ▶ Start — run the skill:

/upside-agent-skills:upside-test

It opens the guided numbered menu — pick a number, or just say “Let me try UpsideMAX”.

1. Install — in a Codex terminal (or run /plugins inside a session and install it from the marketplace tab):

codex plugin marketplace add upsidemax/upside-agent-skills
codex plugin add upside-agent-skills@upside-agent-skills

2. ▶ Start — in the Codex chat, type / and choose upside-test, or just say “Let me try UpsideMAX”. It opens the guided numbered menu.

If your Codex build predates the plugin marketplace, use the Terminal section below — it needs no plugin system.

1. Install — Cursor imports skills through its UI (no CLI): Customize → Rules → Add Rule → Remote Rule (GitHub), and paste https://github.com/upsidemax/upside-agent-skills.(Or drop them into the skills folder: git clone https://github.com/upsidemax/upside-agent-skills && cp -R upside-agent-skills/skills/* ~/.cursor/skills/, then reload Cursor.)2. ▶ Start — in Agent chat, type / and choose upside-test, or just say “Let me try UpsideMAX”. It opens the guided numbered menu.

Before registering you’ll need an alpha test invitation code — the assistant asks for it (or set UPSIDE_INVITE_CODE=<your-code>); request one from the UpsideMAX team. Python 3.9+ is required, and the skill installs its own Python dependencies on first run.

Prefer the terminal?

The upside-test launcher is also a plain script — it works the same whether you run it through Claude Code, Codex, Cursor, or no assistant at all. curl / tar ship with macOS, Linux, and Windows 10+.

curl -L https://github.com/upsidemax/upside-agent-skills/archive/refs/heads/main.tar.gz | tar xz
cd upside-agent-skills-main
export UPSIDE_INVITE_CODE=<your-code>          # request one from the UpsideMAX team
python3 skills/upside-test/scripts/play.py   # numbered menu; add `full` to run the demo

Registers a test account, funds it, and lets you trade — the full experience from your shell. (git clone, or a ZIP download, work too.)

Using it

The skill shows a numbered menu — reply with a number to run a flow. Or skip the menu and just say what you want; the assistant maps it to the right flow:

You say	The assistant does
”Let me try UpsideMAX”	Runs the whole flow: account → test funds → a trade at the current price
”Buy 1 BTC”	Places a market order and reports whether it filled
”Show my positions”	Prints your open positions and balances
”Watch live trades”	Opens a live price feed
”What’s leverage?”	Explains the concept in plain language

Replies come back in your language. Registration needs an alpha test invitation code — the assistant asks for it (request one from the UpsideMAX team).

Prefer to see the code behind a step? Ask the assistant to “show the request” — the test drive can print the exact signed POST /exchange envelope it sent, so you can lift it straight into your own integration. From there, the Authentication and Exchange API pages cover the full signing scheme and every action.

Good to know

Devnet only. The plugin targets Devnet by default; Mainnet access is arranged with the UpsideMAX team.
Keys stay local. Wallets are generated at runtime and stored in a local session file — you’re never asked to paste a private key into chat.
It’s a starting point. Use it to learn the flows quickly, then build your own integration against the REST and WebSocket APIs documented in the rest of these docs.

upsidemax/upside-agent-skills

​What’s in the plugin

​Install & start

​Prefer the terminal?

​Using it

​Good to know

What’s in the plugin

Install & start

Prefer the terminal?

Using it

Good to know