Key Takeaways
Binance Skills let AI agent skills pull public Binance market data and run Web3 and token analysis from simple natural-language prompts. Many of these queries need no API key.
To enable account features and spot trading, you need to add Binance API credentials. It is a good idea to start on Testnet before moving to Mainnet.
Mainnet trading calls for tighter security: IP restrictions, least-privilege permissions with no withdrawals, and preferably sub-account keys funded with a limited balance.
Built-in safeguards such as key masking and a "CONFIRM" step before trades can help reduce risk, but you still need to protect the host machine and rotate API keys regularly.
Introduction
Binance Skills are Web3 and trading skill packs designed for autonomous AI agents such as OpenClaw, Claude Code, Codex, and Gemini CLI. With the right runtime setup, these skills let your AI agent query real-time Binance market data, run on-chain and token analysis workflows, perform token security checks, and execute spot account and trading actions when you add API keys.
This guide is divided into two phases. Part 1 covers installing the skills and exploring public market data, which needs no API key. Part 2 covers adding API credentials for account and trading actions, and you will require an API key.
Part 1: Install Skills and Use Public Data (No API Keys)
1. How to install Binance Skills
Installing Binance Skills is very simple. If you are using an AI agent via a command-line interface or chat terminal, simply instruct your AI Agent with the following prompt:
Install Binance Skills for me. Please run the command: npx skills add binance/binance-skills-hubThe agent will download the official skill sets and integrate them into its operating memory.
Alternatively, you can run it directly from your terminal, as shown below.
npx skills add binance/binance-skills-hubFollow the instructions and select your preferred installation method.
Note: It’s recommended to restart your AI Agent after installing skills. Even after a restart, it may take some time until the AI Agent is able to access newly installed skills.
You can also ask your agent “what skills do you have?” to check which ones are available.
2. Getting started with public endpoint examples
Once the installation is complete, you can talk to your AI Agent in natural language to pull sophisticated market intelligence. For market data queries, Binance public endpoints are enough (no need for API keys).
Prompt examples:
Find the top 3 USDT trading pairs with the highest gains on Binance in the past 24 hours.
Show today’s top trending tokens and smart-money inflows.
Run a token security audit for [token/contract] on BSC or Solana.
Fetch BTC real-time market data and summarize recent K-line behavior.
Important Note for OpenClaw Users
If you use OpenClaw and the agent says it cannot execute spot/public requests despite skills being installed, check the tool profile:
openclaw config get tools.profile If it says “messaging”, runtime execution or network tools may be too limited for instruction-based skills. To fix this, you can switch to a profile that allows runtime tools (or use a dedicated trading agent).
Recommended: keep your main messaging agent restrictive, and use a separate trading/test agent for market operations. Use the following commands to switch your agent tool profile:
openclaw config set tools.profile coding openclaw gateway restart Here are other Prompt examples you can try:
Market Ranking: "Query the crypto market rankings for today. Show me the top trending tokens and smart money inflows."
Token Security Audit: "Can you run a token audit on [Insert Token Name/Contract Address]? Check if there are any detected scams or malicious contract functions on BSC or Solana."
Technical Analysis: "Search for BTC and fetch the real-time market data. Generate a summary of the latest K-Line candlestick charts."
Part 2: Configure API Keys & Hands-On Trading
While public data is very useful, unlocking the true power of your AI Agent requires authentication. If you want the AI to check more specific data, you will need to configure your API keys. This can enable your AI agent to do tasks like:
Checking your account balances
Querying personal order history
Placing/canceling spot orders.
1. Get Binance API Keys
Testnet (recommended for beginners)
If you are just learning how AI interacts with market APIs, we strongly recommend starting with the Binance Testnet. Leveraged trading and automated execution can drain accounts rapidly if the AI misunderstands a prompt.
Visit the Binance Spot Testnet.
Log in using your GitHub account.
You will automatically be issued a test API Key and Secret Key.
Note: The Testnet provides simulated virtual funds. No real assets are involved, making it perfect for testing.
Mainnet (for live trading)
Once you are comfortable with your agent's behavior, you can transition to the Mainnet.
Log in to your Binance account.
Navigate to Profile → API Management.
Click Create API and select "System generated."
Crucial Step: To enable "Spot & Margin Trading" for your API key, you must first configure IP restrictions. Binance requires at least one trusted IP address to be whitelisted before the trading toggle can be activated.
After completing the security verification, copy your API Key and Secret Key.
Best Practice: Never use your primary account for API bots. Instead, create a Sub-Account and generate API keys from it. Fund this sub-account with a strictly limited balance and do not enable withdrawals for agent trading keys. This limits the AI's access and avoids any unintended impact on your primary portfolio.
2. Configure API Keys in Your Agent
Once you have generated your keys, you can hand them over to your AI.
I want to configure my Binance API. Here are my mainnet keys. API Key: [Your Key] Secret Key: [Your Secret]The AI will parse these credentials and store them locally in a TOOLS.md or equivalent configuration file. You can configure multiple accounts simultaneously (e.g., keeping one Testnet account for testing strategies, and one Mainnet for live execution).
Built-In Key Security
To protect your funds, the official Binance Spot Skill incorporates strict, "Agentic Zero-Trust" security measures:
Masking: The API Key only displays the first 5 and last 4 characters (e.g., su1Qc...8akf). The Secret Key is permanently masked, showing only the last 4 characters (e.g., ***...aws1).
Human-in-the-Loop: Before executing any Mainnet trade, the AI will pause and require you to type "CONFIRM".
Local Storage: Keys are stored entirely on your local machine and are never uploaded to the AI's native cloud servers or any external databases.
3. Trading Examples
With your keys configured, your AI Agent can now act as your personal trading desk. Try combining volume analysis with execution commands:
Checking Balances: "Check my Binance Spot wallet balance. How much USDT do I have available?"
Placing a Spot Trade: "Buy 0.1 BNB at market price."
Managing Orders: "Query my order history for the last 24 hours and summarize my total PnL."
Placing an OCO order: “Place an OCO order for BNB position with 20% take-profit and 20% stop-loss from the entry price.”
FAQ
What if I make a mistake in my prompt and lose money?
Always use the Testnet first. It provides simulated funds, so you can practice freely without financial risk. Never grant the agent access to funds you cannot afford to lose. AI models can sometimes misread market structures or misinterpret an instruction, so treat automation with caution.
Could my API keys be leaked by the AI agent?
The keys are stored locally on your device’s files, but system security is your responsibility. To reduce risk, enable IP restrictions so only requests from your home or server’s static IP are allowed, and never check the "Enable Withdrawals" box when creating your key. Rotate keys every 30 to 90 days, and keep the host machine free of malware, since info-stealers and phishing attacks often target locally stored credentials.
Do I need an API key just to check market data?
No. Many public market data queries, such as price rankings, trending tokens, and token security audits, work through Binance public endpoints without any API key. You only need API credentials for account-specific actions like checking balances or placing orders.
Which AI agents work with Binance Skills?
Binance Skills are designed for autonomous AI agents that support runtime tools, including OpenClaw, Claude Code, Codex, and Gemini CLI. If an agent cannot run public or spot requests after installation, its tool profile may be too restrictive and can usually be adjusted.
Closing Thoughts
Binance AI agent skills can turn an AI assistant into a practical crypto research and trading helper, starting with public data and scaling up to authenticated actions. The safer path is to begin on Testnet, lock down API permissions, and treat automation with the same care you would apply to any trading tool.