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. The guided test drive (upside-test) runs on Devnet; the other skills target Mainnet. It’s the fastest way to experience the exchange without writing any code first.

The test drive (upside-test) runs on Devnet (https://dev.upsidemax.xyz). The other skills target Mainnet (https://upsidemax.xyz), which trades real funds. Set UPSIDE_BASE_URL to switch either way; the signing chain ID follows the URL. A new account starts with no balance: on Mainnet, deposit funds before trading; for Devnet funds, contact the UpsideMAX team. Start small.

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, check its balance, and see what funding it needs.
`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 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 an account, checks its balance, 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 → balance check → a resting limit order, then cancels it
”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 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

Test drive on Devnet, the rest on Mainnet. Orders placed through the trading skills use real funds. Point UPSIDE_BASE_URL at Devnet to practise first.
Keys stay local. Wallets are generated at runtime and stored in a local .env file readable only by you — scripts read keys from it, never from the command line, and the private key is never printed or pasted 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