We've built Grvt Agent Skills: a set of open-source capabilities that let users and AI agents interact with our exchange entirely through natural language. Whether you're automating a trading workflow, building an AI-powered bot, or simply want to check your portfolio without touching a UI, Agent Skills make it possible.

This guide covers everything you need to know: what Grvt Agent Skills are, how to install them, and how to start using them with any compatible AI agent.

What Are Grvt Agent Skills?

Grvt Agent Skills are a collection of structured AI instructions, called skills, that tell any compatible AI agent how to interact with our exchange infrastructure. They are built on the open skills ecosystem and work seamlessly with agents like Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI, and more.

Once installed, you can type commands in plain language and your AI agent will translate them into authenticated API calls to Grvt, handling everything from order signing to session management behind the scenes.

Think of it as giving your AI agent a trading desk on Grvt.

What You Can Do with Grvt Agent Skills

With Grvt Agent Skills, AI agents can:

• Query real-time market data: prices, orderbooks, funding rates, candlesticks
• Manage your account: balances, open positions, unrealized PnL, trade history
• Execute perpetual trades: place limit/market orders, set TP/SL, cancel orders
• Configure positions: set leverage, switch between cross and isolated margin

We're continuing to expand these skills with referral and investment features coming soon and much more based on your feedback.

Prerequisites

Before getting started, make sure you have the following:

• Python 3.8+ installed on your machine
• An AI agent that supports the open skills ecosystem (Claude Code, Cursor, Codex, Gemini CLI, etc.)
• A Grvt account with API keys generated
  • Production: https://grvt.io/exchange/account/api-keys
  • Testnet: https://testnet.grvt.io/exchange/account/api-keys

We use two types of API keys:

Installation

Step 1 — Install the skills

Install all three Grvt skills at once:

npx skills add gravity-technologies/grvt-skills

Or install them individually:

npx skills add gravity-technologies/grvt-skills/skills/perpetual-trading
npx skills add gravity-technologies/grvt-skills/skills/market-data
npx skills add gravity-technologies/grvt-skills/skills/account-management

Step 2 — Install the Python SDK

Grvt Agent Skills rely on grvt-pysdk to communicate with the exchange:

pip install grvt-pysdk

Step 3 — Configure your credentials

Create a .env file in your project root with your API keys:

# Trading API Key — for orders, positions, and trading account operations
GRVT_TRADING_API_KEY=<your Trading API Key>
GRVT_TRADING_PRIVATE_KEY=<private key for Trading API Key>

# Funding API Key — optional, for funding account transfers
GRVT_FUNDING_API_KEY=<your Funding API Key>
GRVT_FUNDING_PRIVATE_KEY=<private key for Funding API Key>

GRVT_ENV=testnet  # Switch to "prod" when ready for live trading

Step 4 — Enable auto-run (recommended)

For the smoothest natural language experience, where your agent executes commands directly without prompting you for code review, enable auto-run in your AI tool:

What can Grvt Agent Skills Do

1. Market Data

Fetch prices, orderbooks, candlesticks, and funding rates. No API key required for public data.

The Market Data skill gives your agent access to our full suite of real-time market information. All market data endpoints are public, making this skill ideal for market analysis, research bots, or price alerting.

What it covers:

• Current prices (mark, index, last, bid/ask)
• Full ticker stats (24h volume, open interest, long/short ratio)
• Orderbook depth (up to 500 levels)
• Recent trades
• OHLCV candlestick data across 16 timeframes (1m to 4w)
• Funding rate history
• Instrument discovery

2. Account Management

Check balances, positions, PnL, and trade history. Requires your Trading API Key.

The Account Management skill gives your agent full visibility into your Grvt trading account. Use it to monitor portfolio health, track funding payments, or pull fill history for analysis.

What it covers:

• USDT balance (total, free, used)
• Sub-account and aggregated account summaries
• Open positions with entry price, mark price, unrealized PnL, ROI, leverage
• Position margin management (add margin, check limits)
• Trade and fill history
• Funding payment history
• Full account history (deposits, withdrawals, transfers)

3. Perpetual Trading

Place, cancel, and manage perpetual futures orders. Requires your Trading API Key.

The Perpetual Trading skill is the core execution layer. It handles EIP-712 order signing, session authentication, and all order types on our perpetual markets.

What it covers:

• Market and limit orders
• Advanced order parameters (GTC, IOC, FOK, AON, post-only, reduce-only)
• Trigger orders (take-profit and stop-loss)
• Order cancellation (by ID, by client ID, or cancel all)
• Open order queries and order history
• Leverage and margin type configuration (cross vs. isolated)

Example Natural Language Commands

Once your agent is set up, just ask it in plain language:

Important Notes

• All orders require EIP-712 signing. The SDK handles this automatically using your GRVT_TRADING_PRIVATE_KEY. You never need to sign manually.
• Always test on testnet first. Set GRVT_ENV=testnet and use exchange.testnet.grvt.io before going live.
• Minimum order size. The minimum notional value per order is 100 USDT (price × amount ≥ 100).
• Market data is public. The Market Data skill works without any API key, making it easy to build read-only bots or dashboards.
• The SDK auto-manages sessions. Authentication cookies are refreshed automatically before expiry; you don't need to re-login.
• order_id from create_order is a placeholder. Use metadata.client_order_id to track and cancel orders after placement.

Additional Resources

• Grvt Exchange
• Grvt API Documentation
• grvt-pysdk on GitHub
• Grvt Skills Repository
• Open Skills Ecosystem
• Learn More About AI Crypto Trading Bots

Have feedback or run into issues? We're actively iterating, join the Grvt community and share your experience and help shape what gets built next.

• Grvt Dicord
• Grvt Telegram (Global)
• Grvt Telegram (Chinese)
• Grvt Telegram (Korea)
• Grvt Telegram (Japanese)