Quick Start Features Commands About CLI Reference → bolt Start Trading on Mainnet
DipCoin CLI

terminal Get Started in 60 Seconds
$ npm install -g dipcoin-cli
code View source on GitHub → dipcoinlab/dipcoin-cli
smart_toy AI Agent Ready
link One URL to Trade
bolt Sui Blockchain
account_balance_wallet On-chain Vaults
AI Agent

Let Your Agent Trade for You.

Hand Claude, GPT-4o, or any MCP-compatible agent one URL. It reads the docs and executes trades on-chain — no code, just conversation.

01

Load the Skill

One URL contains every command, parameter, and example your agent needs. No plugins, no setup.

SKILL.md — URL
# Paste this into your agent's system prompt
https://raw.githubusercontent.com/
dipcoinlab/dipcoin-cli/main/SKILL.md

check_circle Claude · GPT-4o · Gemini · any MCP agent

02

Brief Your Agent

Paste the URL in your system prompt or mention it in chat. The agent reads it, understands the API, and confirms it's ready.

person
Use this skill: https://raw.githubusercontent.com/dipcoinlab/dipcoin-cli/main/SKILL.md
smart_toy
Got it — I can check prices, open positions, set TP/SL, and manage your perp trades. What would you like to do?

check_circle System prompt or inline — both work

03

Chat to Trade

Give orders in plain English. Your agent translates them into CLI commands and executes on Sui mainnet.

Agent ↔ dipcoin-cli
# You tell your agent:
"Long BTC $200 at 10x, stop at 87k"
# Agent runs:
$ dipcoin-cli trade buy BTC 200USDC 10x \
--sl 87000
✓ LONG BTC-PERP · 10× · 200 USDC

check_circle Risk limits, rebalancing, analytics — all in natural language

Quick Start

Up and running in 60 seconds.

No complex setup. Install, drop in your key, and start trading.

01

Install

Install the CLI globally via npm. Works on macOS, Linux, and Windows.

dipcoin-cli — zsh
$ npm install -g dipcoin-cli
# Requires Node.js 18+

check_circle Supports ED25519 · Secp256k1 · Secp256r1

02

Configure

Drop in your Sui private key or 12-word mnemonic. One config file, done.

dipcoin-cli — zsh
$ mkdir -p ~/.config/dipcoin
$ cat > ~/.config/dipcoin/env << 'EOF'
DIPCOIN_PRIVATE_KEY=suiprivkey1...
DIPCOIN_NETWORK=mainnet
EOF

check_circle Or use DIPCOIN_MNEMONIC for 12-word phrase

03

Trade

Open a long with TP/SL in one command. Market or limit, your choice.

dipcoin-cli — zsh
$ dipcoin-cli trade buy BTC 100USDC 10x \
--tp 105000 --sl 90000
✓ Order Filled · LONG BTC-PERP ▲

check_circle Add --json for machine-readable output

What you can do

Everything. From the terminal.

Trade perps, manage vaults, query history — all scriptable, all composable.

dipcoin-cli — zsh
Command Reference

Every command, at a glance.

From market data to vault management. Add --json for machine-readable output.

Prices, order book, and on-chain oracle data. Symbols auto-normalize — BTC and BTC-PERP are equivalent.

$ dipcoin-cli market pairs # all pairs + funding rates
$ dipcoin-cli market ticker BTC # price, volume, OI
$ dipcoin-cli market orderbook BTC # bids & asks
$ dipcoin-cli market oracle BTC # on-chain Pyth price

Long, short, limit, TP/SL — all in one command. Use --reduce-only to close without flipping direction.

$ dipcoin-cli trade buy BTC 100USDC 10x # market long
$ dipcoin-cli trade buy BTC 100USDC 10x --price 95000 # limit
$ dipcoin-cli trade buy BTC 100USDC 10x --tp 105000 --sl 90000 # TP/SL
$ dipcoin-cli trade sell BTC 0 10x --qty 0.01 --reduce-only # close
$ dipcoin-cli trade orders # pending orders
$ dipcoin-cli trade cancel BTC-PERP <hash> # cancel

Monitor uPnL and liquidation levels. Add TP/SL after entry or inject margin to push your liquidation price down.

$ dipcoin-cli position list # all positions
$ dipcoin-cli position tpsl BTC --side sell --quantity 0.106 --leverage 10 \
--tp-trigger 105000 --sl-trigger 90000 # set TP/SL
$ dipcoin-cli position margin add BTC 50 # add margin
$ dipcoin-cli position margin remove BTC 50 # remove margin

Follow top traders or launch your own fund. Vault shares are on-chain — deposit earns shares, withdraw burns them for USDC.

$ dipcoin-cli vault list-all --filter Leading # browse vaults
$ dipcoin-cli vault deposit <vaultId> 500 # follow
$ dipcoin-cli vault withdraw <vaultId> --all # exit

$ dipcoin-cli vault create --name "MyFund" --trader <address> --max-cap 100000 --min-deposit 10 --creator-share 2 --profit-share 20 --initial 500
$ dipcoin-cli vault claim <vaultId> # claim fees

Full audit trail of orders, funding, and balance changes. All commands support --vault, --begin-time, and --json.

$ dipcoin-cli history orders --symbol BTC-PERP # order history
$ dipcoin-cli history funding # funding payments
$ dipcoin-cli history balance # balance ledger
$ dipcoin-cli history orders --json | jq '.[].status' # pipe to jq

Account equity, margin, and PnL. Use balance for raw on-chain wallet coins — separate from your trading account.

$ dipcoin-cli account info # equity, margin, PnL
$ dipcoin-cli account deposit 500 # deposit USDC
$ dipcoin-cli account withdraw 500 # withdraw USDC
$ dipcoin-cli balance # on-chain wallet

Earn passive income from your invitees' trading fees. They get a discount — you get a cut of every trade they make.

$ dipcoin-cli referral link # your code & earnings
$ dipcoin-cli referral bind DIPFREN # get a fee discount
$ dipcoin-cli referral change-code MYCODE42 # update code
$ dipcoin-cli referral invitees # who joined via your link