Portal Community
What it does: The Binance node (binance) exposes Binance's Spot v3 REST API as workflow steps — 11 operations across 3 resources (account, order, marketData). Account and order calls are HMAC-SHA256 signed with your API key/secret; market data calls are public and need no credential.

Quick Start

  1. Add a Binance node to your workflow
  2. Try it with no credential first: set resource to marketData and operation to getTickerPrice, leave symbol blank to fetch every symbol
  3. For account/order calls, add a credentialId pointing at a vault API-key credential holding your Binance API key and secret (see Authentication)
  4. Set resource to account and operation to getAccountInfo
  5. Run the workflow — the node returns your asset balances
Tip: Every operation shares the same top-level config keys — resource, operation, credentialId — plus a small set of operation-specific fields. Learn the shared shape once on Input & Output and every operation below follows it.

Pages in This Guide

Configuration

appsettings.json, rate-limit defaults, and dependency registration.

Authentication

API key/secret vault credential and HMAC-SHA256 request signing.

Account Operations

getAccountInfo and getOrderRateLimit — balances and your rate-limit budget.

Placing Orders

placeMarketOrder and placeLimitOrder — submit new spot orders.

Managing Orders

getOrder, cancelOrder, getOpenOrders, getOrderHistory.

Market Data Operations

getTickerPrice, getKlines, getOrderBookDepth — no credential required.

Rate Limiting

Request-weight budgets, proactive throttling, and IP bans.

Error Codes

The full BINANCE_* error taxonomy and what triggers each one.

Input & Output

The shared config-key pattern and how errors surface.

Examples

Worked workflow patterns using this node.

Troubleshooting

Common errors and how to fix them.

Roadmap

What's explicitly out of scope for v1, and known gaps.

Core Concepts

Spot REST API, v1 Scope

Every operation on this node calls Binance's Spot v3 REST API (api.binance.com). Margin, Futures, and any WebSocket streaming design are explicitly out of scope for this version — see Roadmap.

Resources

Signed vs. Public Endpoints

account and order operations are HMAC-SHA256 signed and require a credentialId. marketData operations are public — no credential is required, though supplying one is honored and raises the per-IP rate-limit bracket. See Authentication.

Operation Summary

ResourceOperationEndpointSignedGuide Page
accountgetAccountInfoGET /api/v3/accountYesAccount Operations
accountgetOrderRateLimitGET /api/v3/rateLimit/orderYesAccount Operations
orderplaceMarketOrderPOST /api/v3/orderYesPlacing Orders
orderplaceLimitOrderPOST /api/v3/orderYesPlacing Orders
ordergetOrderGET /api/v3/orderYesManaging Orders
ordercancelOrderDELETE /api/v3/orderYesManaging Orders
ordergetOpenOrdersGET /api/v3/openOrdersYesManaging Orders
ordergetOrderHistoryGET /api/v3/allOrdersYesManaging Orders
marketDatagetTickerPriceGET /api/v3/ticker/priceNoMarket Data Operations
marketDatagetKlinesGET /api/v3/klinesNoMarket Data Operations
marketDatagetOrderBookDepthGET /api/v3/depthNoMarket Data Operations