Skip to main content
Give your AI its own Yellow.pro trading account: a separate account under your login, with permissions you control.
What this covers
  • Connect your wallet
  • Create a dedicated agent sub-account
  • Pair an AI client
  • Verify that it works
  • Fund the agent and try it out
Estimated setup time: about 10 minutes the first time.
An agent sub-account is a separate account under your main login, with its own balance. Your AI only ever touches funds you move into that sub-account, never your main account. An agent can never withdraw, regardless of which permissions you grant it. Withdrawals always require your signature on the main account.

​
Step 1 — Connect your wallet

Go to yellow.pro and click Connect in the top-right corner. Connect button in the top-right of yellow.pro Pick a wallet — MetaMask, Phantom, Rabby, or WalletConnect — or continue with Google. Wallet selection dialog If you connect a wallet, approve two prompts from the wallet extension:
  1. A connection request
  2. A signature request ("Please sign this message to authenticate...")
Signing is free. The signature proves you own the wallet. It is not a transaction.
Once connected, a welcome panel walks you through the quick path: deposit or convert to USDT, transfer spot to perpetual, and open your first position. You can follow it or skip it — click Start trading or × to dismiss.
None of those steps are required before setting up your agent.
Welcome to Yellow Pro panel

​
Step 2 — Open the agent onboarding page

Click AI agent in the top navigation bar. AI agent link in the top navigation This takes you to Give your AI its own trading account. Agent onboarding landing page The flow has four steps: Agent sub-account, Connect, Verify, and Agent dashboard.

​
Step 3 — Create your agent sub-account

The page explains what your AI will be able to do: Click Create your agent account. This creates the account only — no key and no funds yet. Create your agent account step Once created, Step 1 turns green and shows your new account: an agent account ID in the form agentic:0x... under your main account, with a balance starting at 0 USDT.
There is nothing to fund yet. You’ll fund the account once your AI is connected.
Agent sub-account created and ready

​
Step 4 — Choose your AI and set its access

Step 2, Connect, asks two questions.

​
Which AI are you using?

Seven clients currently work, each with a one-command setup. Choosing an AI client and access level

​
Should it be allowed to trade?

Read-only

Reads prices, positions and balances, and answers questions. Cannot trade.Scopes: read:spot, read:perp

Trading on

Places and cancels orders using the agent account’s available margin.Adds: trade:spot, trade:perp
Start with read-only. You can change the access level later from the agent dashboard without redoing this flow.

​
Step 5 — Get your pairing code

Yellow.pro generates a one-time pairing code and the exact command that redeems it, pre-filled with your selected client and permission choices. Pairing code and copy command
This code is not your API key or secret. It is a one-time claim that you redeem once. Redeeming it mints the actual key locally on your machine — Yellow.pro never sees or stores that key.The code is single-use and expires in about 10 minutes, so don’t generate it until you’re ready for the next step. If it expires, click Change and get a new code.
Click Copy command, then continue to the section for your client.

​
Step 6 — Install your AI client, log in, and pair

If your AI client isn’t installed yet, set it up first:

Install Claude Code CLI

Recommended. Install, verify, and log in.

Install Codex CLI

OpenAI’s CLI, if that’s your client.
Claude Code and Claude Desktop are different applications. Claude Desktop is the chat app with a window; Claude Code runs in your terminal. The pairing command registers with Claude Code specifically.

​
Claude Code walkthrough

1

Install Claude Code

Running the Claude Code installerClaude Code installed successfully
2

Verify the install

Open a new terminal window and run:
You should see a version number such as 2.1.267.
If you see command not found, add the install location to your PATH:
Then open a fresh terminal and try claude --version again.
3

Log in

Run:
Starting Claude CodeThe first time you run Claude Code in a new folder it asks whether you trust the workspace. Choose Yes, I trust this folder.Workspace trust promptNext, choose Claude account with subscription.Selecting a login methodComplete the browser sign-in that opens, then click Authorize.Authorizing Claude Code
If you see Claude Max or Pro is required to connect to Claude Code, your Claude.ai account is on the free plan. Upgrade to Pro, Max, Team, or Enterprise, or sign in with an API key instead.
You’ll return to the terminal logged in, and can pick a colour theme. This only affects how Claude Code looks, so any option is fine.Choosing a colour themeIf billing shows pay-per-use instead of your plan, type /login inside the session. Once confirmed, exit back to the normal prompt:
4

Run the pairing command

Back in the same terminal — at the normal % prompt, not inside Claude — paste and run the command Yellow.pro gave you in Step 5. This installs the Yellow.pro MCP package and registers it with Claude Code in one go.Pasting the pairing commandPairing command outputThe confirmation shows the account type (subaccount), the granted scopes such as read:spot and read:futures, where the credential was saved locally, and whether trading was enabled.
Whether trading is enabled is determined entirely by the permission level you selected in Step 4.
Restart required. If the output includes "restart_required": true, exit the existing Claude session and run claude again so it picks up the new MCP server.
5

Confirm registration

Run claude, then inside the session:
yellow_pro should show as connected. That’s enough to continue — you’ll ask it something in Step 9.

​
Other supported clients

The pairing command works the same way for all seven supported clients. Run the command Yellow.pro generated for your selected client. Manual configuration paths for Gemini CLI, Cursor, Hermes, and OpenClaw are on the Installation page.

​
Step 7 — Verify it’s working

Return to the Yellow.pro tab. Step 2 should now show Connected, and Step 3, Verify, becomes active. Click Verify connection. This runs a set of read-only checks against your new key. Verify connection step
Safe verification. Nothing is created and no order is placed. These checks are read-only and safe to re-run anytime.
The checks confirm that the agent sub-account exists, that an active key is connected, and that your AI has actually made a successful call.

​
If a check doesn’t pass

The most common causes are on the CLI side:
If the client was already running when you paired it, look for "restart_required": true in the pairing output. Exit the client and start it again.
Scroll back in your terminal and check for an error before the "connected": true confirmation.
Make sure the pairing command was pasted into your normal shell prompt, not an active Claude or Codex session.
Fix the issue, then click Verify connection again.

​
Step 8 — Open your agent dashboard

Once verification passes, Step 4 changes to Live. Click Open dashboard. Verification passed Open dashboard button You’ll see your Agent Overview: the connected AI, key details, trading status, current portfolio, and transfer controls. Agent Overview dashboard From the dashboard you can revoke the key, change its trading permission, fund or withdraw from the agent sub-account, and connect another AI to the same account.
If trading is off, the dashboard shows a Trading OFF badge and an Enable trading control. Turning it on applies to the agent account only.
Dashboard with trading off

​
Step 9 — See it in action

A fresh agent sub-account starts with 0 USDT. Click Fund it or Deposit on the dashboard to move balance from your main account before asking your AI to do anything that requires funds. See Fund your agent for the full transfer flow.
Read-only questions work fine with a zero balance.
Then return to your AI client and try it out.
Ask: “What’s the funding rate on BTC-PERP?”Your AI reads live market data through the connected key.Funding rate answer
Once you’ve asked it something real, return to Yellow.pro and click Verify connection again. Every check should now show as confirmed.

​
Next steps

Fund your agent

Move USDT between your main and agent accounts.

Manage your API keys

Review, freeze, or revoke keys.

Agentic portfolio

Track the agent’s performance separately.

Troubleshooting

Fixes for the most common issues.