grvt-exchange
Trade on GRVT (Gravity Markets) derivatives exchange via the grvt-cli tool. Use when the user wants to trade crypto derivatives, place or cancel orders, check positions, view market data (orderbook, candles, tickers, funding rates), manage account balances, transfer funds between sub-accounts, withdraw to Ethereum, set leverage, query trade or order history, or interact with the GRVT API in any way. Covers perpetuals, futures, and options on GRVT.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/madeinusmate/grvt-markets-agent-skillGRVT Exchange CLI
IMPORTANT: Community Project Disclaimer
grvt-cliis a community hobby project. It is NOT officially supported, endorsed, audited, or maintained by the GRVT team. No security audit or formal code review has been performed.The code has not been audited for security vulnerabilities. By using this tool the user acknowledges and accepts the risk of total loss of funds.
The user is solely responsible for any financial losses, leaked credentials, or unintended trades that may result from using this software.
This tool stores API keys and private keys in plaintext on disk (with
0600file permissions). Keys should never be shared or used on untrusted machines.Before using this CLI on behalf of the user, you MUST inform them of this disclaimer and get their explicit acknowledgment.
grvt is a CLI tool and Node.js library for trading on GRVT (Gravity Markets), a crypto derivatives exchange supporting perpetuals, futures, and options.
Package: @madeinusmate/grvt-cli (npm). Binary: grvt. Requires Node.js >= 20.
Safety Recommendations
- Only use testnet until the user fully understands the CLI behavior.
- Review the source code before trusting it with real funds.
- Keep private keys out of shell history (use
grvt setupwhich reads from stdin). - Rotate API keys regularly.
- Never use the CLI with more funds than the user can afford to lose.
Installation
pnpm add -g @madeinusmate/grvt-cli
Verify: grvt --version
First-Time Setup
The interactive wizard handles everything:
grvt setup
The setup wizard displays a disclaimer requiring explicit acceptance before proceeding. It is interactive and reads sensitive input from stdin (keeping keys out of shell history). It walks through: environment, API key, private key, and default sub-account ID, then authenticates automatically.
Note: Because grvt setup is interactive and requires user input, agents cannot run it directly. Use the manual setup flow below instead.
Manual setup (recommended for agents):
grvt config set env testnet
grvt auth login --api-key YOUR_API_KEY --private-key 0xYOUR_PRIVATE_KEY
grvt config set subAccountId YOUR_SUB_ACCOUNT_ID
Verify setup:
grvt auth status
grvt config list
Configuration
Config file: ~/.config/grvt/config.toml (permissions 0600).
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-madeinusmate-grvt-markets-agent-skill": {
"enabled": true,
"auto_update": true
}
}
}