spot

Binance Spot request using the Binance API. Authentication requires API key and secret key. Supports testnet, mainnet, and demo.

Aller à l'installation

Dépôt: tradecatlabs/tradecat-public
Dernière activité de la source: 18 mai 2026 à 12:53
Langue détectée de SKILL.md: anglais
Étoiles: 956
Forks: 243

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.

npx skills add https://github.com/tradecatlabs/tradecat-public --skill spot

La commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.

Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

Explorateur de fichiers

4 fichiers

SKILL.md

Instructions source · Aperçu en lecture seule

Retour à la recherche Retour à l’installation

symbol: Symbol to query (e.g., BNBUSDT)
symbols: List of symbols to query
permissions: List of permissions to query
showPermissionSets: Controls whether the content of the permissionSets field is populated or not. Defaults to true (e.g., true)
symbol: (e.g., BNBUSDT)
fromId: ID to get aggregate trades from INCLUSIVE. (e.g., 1)
startTime: Timestamp in ms to get aggregate trades from INCLUSIVE. (e.g., 1735693200000)
endTime: Timestamp in ms to get aggregate trades until INCLUSIVE. (e.g., 1735693200000)
limit: Default: 500; Maximum: 1000. (e.g., 500)
timeZone: Default: 0 (UTC)
recvWindow: The value cannot be greater than 60000. Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified. (e.g., 5000)
timestamp: (e.g., 1)
quantity: (e.g., 1)
quoteOrderQty: (e.g., 1)
price: (e.g., 400)
newClientOrderId: A unique id among open orders. Automatically generated if not sent. Orders with the same newClientOrderID can be accepted only when the previous one is filled, otherwise the order will be rejected.
strategyId: (e.g., 1)
strategyType: The value cannot be less than 1000000. (e.g., 1)
stopPrice: Used with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders. (e.g., 1)
trailingDelta: See Trailing Stop order FAQ. (e.g., 1)
icebergQty: Used with LIMIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT to create an iceberg order. (e.g., 1)
pegOffsetValue: Priceleveltopegthepriceto(max:100). SeePeggedOrdersInfo (e.g., 1)
orderId: (e.g., 1)
origClientOrderId:
newQty: newQty must be greater than 0 and less than the order's quantity. (e.g., 1)
cancelNewClientOrderId: Used to uniquely identify this cancel. Automatically generated by default.
cancelOrigClientOrderId: Either cancelOrderId or cancelOrigClientOrderId must be sent.
If both cancelOrderId and cancelOrigClientOrderId parameters are provided, the cancelOrderId is searched first, then the cancelOrigClientOrderId from that result is checked against that order.
If both conditions are not met the request will be rejected.
cancelOrderId: Either cancelOrderId or cancelOrigClientOrderId must be sent.
If both cancelOrderId and cancelOrigClientOrderId parameters are provided, the cancelOrderId is searched first, then the cancelOrigClientOrderId from that result is checked against that order.
If both conditions are not met the request will be rejected. (e.g., 1)
listClientOrderId: A unique Id for the entire orderList
quantity: (e.g., 1)
limitClientOrderId: A unique Id for the limit order
price: (e.g., 1)
limitStrategyId: (e.g., 1)
limitStrategyType: The value cannot be less than 1000000. (e.g., 1)
limitIcebergQty: Used to make the LIMIT_MAKER leg an iceberg order. (e.g., 1)
stopClientOrderId: A unique Id for the stop loss/stop loss limit leg
stopPrice: (e.g., 1)
stopStrategyId: (e.g., 1)
stopStrategyType: The value cannot be less than 1000000. (e.g., 1)
stopLimitPrice: If provided, stopLimitTimeInForce is required. (e.g., 1)
stopIcebergQty: Used with STOP_LOSS_LIMIT leg to make an iceberg order. (e.g., 1)
computeCommissionRates: Default: false See Commissions FAQ to learn more.
orderListId: Either orderListId or listClientOrderId must be provided (e.g., 1)
aboveClientOrderId: Arbitrary unique ID among open orders for the above order. Automatically generated if not sent
aboveIcebergQty: Note that this can only be used if aboveTimeInForce is GTC. (e.g., 1)
abovePrice: Can be used if aboveType is STOP_LOSS_LIMIT , LIMIT_MAKER, or TAKE_PROFIT_LIMIT to specify the limit price. (e.g., 1)
aboveStopPrice: Can be used if aboveType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT. Either aboveStopPrice or aboveTrailingDelta or both, must be specified. (e.g., 1)
aboveTrailingDelta: See Trailing Stop order FAQ. (e.g., 1)
aboveStrategyId: Arbitrary numeric value identifying the above order within an order strategy. (e.g., 1)
aboveStrategyType: Arbitrary numeric value identifying the above order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)
abovePegOffsetValue: (e.g., 1)
belowClientOrderId: Arbitrary unique ID among open orders for the below order. Automatically generated if not sent
belowIcebergQty: Note that this can only be used if belowTimeInForce is GTC. (e.g., 1)
belowPrice: Can be used if belowType is STOP_LOSS_LIMIT, LIMIT_MAKER, or TAKE_PROFIT_LIMIT to specify the limit price. (e.g., 1)
belowStopPrice: Can be used if belowType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT or TAKE_PROFIT_LIMIT Either belowStopPrice or belowTrailingDelta or both, must be specified. (e.g., 1)
belowTrailingDelta: See Trailing Stop order FAQ. (e.g., 1)
belowStrategyId: Arbitrary numeric value identifying the below order within an order strategy. (e.g., 1)
belowStrategyType: Arbitrary numeric value identifying the below order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)
belowPegOffsetValue: (e.g., 1)
workingClientOrderId: Arbitrary unique ID among open orders for the working order. Automatically generated if not sent.
workingPrice: (e.g., 1)
workingQuantity: Sets the quantity for the working order. (e.g., 1)
workingIcebergQty: This can only be used if workingTimeInForce is GTC, or if workingType is LIMIT_MAKER. (e.g., 1)
workingStrategyId: Arbitrary numeric value identifying the working order within an order strategy. (e.g., 1)
workingStrategyType: Arbitrary numeric value identifying the working order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)
workingPegOffsetValue: (e.g., 1)
pendingClientOrderId: Arbitrary unique ID among open orders for the pending order. Automatically generated if not sent.
pendingPrice: (e.g., 1)
pendingStopPrice: (e.g., 1)
pendingTrailingDelta: (e.g., 1)
pendingIcebergQty: This can only be used if pendingTimeInForce is GTC or if pendingType is LIMIT_MAKER. (e.g., 1)
pendingStrategyId: Arbitrary numeric value identifying the pending order within an order strategy. (e.g., 1)
pendingStrategyType: Arbitrary numeric value identifying the pending order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)
pendingPegOffsetValue: (e.g., 1)
pendingAboveClientOrderId: Arbitrary unique ID among open orders for the pending above order. Automatically generated if not sent.
pendingAbovePrice: Can be used if pendingAboveType is STOP_LOSS_LIMIT , LIMIT_MAKER, or TAKE_PROFIT_LIMIT to specify the limit price. (e.g., 1)
pendingAboveStopPrice: Can be used if pendingAboveType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT (e.g., 1)
pendingAboveTrailingDelta: See Trailing Stop FAQ (e.g., 1)
pendingAboveIcebergQty: This can only be used if pendingAboveTimeInForce is GTC or if pendingAboveType is LIMIT_MAKER. (e.g., 1)
pendingAboveStrategyId: Arbitrary numeric value identifying the pending above order within an order strategy. (e.g., 1)
pendingAboveStrategyType: Arbitrary numeric value identifying the pending above order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)
pendingAbovePegOffsetValue: (e.g., 1)
pendingBelowClientOrderId: Arbitrary unique ID among open orders for the pending below order. Automatically generated if not sent.
pendingBelowPrice: Can be used if pendingBelowType is STOP_LOSS_LIMIT or TAKE_PROFIT_LIMIT to specify limit price (e.g., 1)
pendingBelowStopPrice: Can be used if pendingBelowType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT or TAKE_PROFIT_LIMIT. Either pendingBelowStopPrice or pendingBelowTrailingDelta or both, must be specified. (e.g., 1)
pendingBelowTrailingDelta: (e.g., 1)
pendingBelowIcebergQty: This can only be used if pendingBelowTimeInForce is GTC, or if pendingBelowType is LIMIT_MAKER. (e.g., 1)
pendingBelowStrategyId: Arbitrary numeric value identifying the pending below order within an order strategy. (e.g., 1)
pendingBelowStrategyType: Arbitrary numeric value identifying the pending below order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)
pendingBelowPegOffsetValue: (e.g., 1)
pendingQuantity: Sets the quantity for the pending order. (e.g., 1)
omitZeroBalances: When set to true, emits only the non-zero balances of an account. Default value: false
fromAllocationId: (e.g., 1)
timestamp: (e.g., 1)
preventedMatchId: (e.g., 1)
fromPreventedMatchId: (e.g., 1)
orderId: (e.g., 1)
fromExecutionId: (e.g., 1)
limit: Default:500; Maximum: 1000 (e.g., 500)

interval: 1s | 1m | 3m | 5m | 15m | 30m | 1h | 2h | 4h | 6h | 8h | 12h | 1d | 3d | 1w | 1M
windowSize: 1m | 2m | 3m | 4m | 5m | 6m | 7m | 8m | 9m | 10m | 11m | 12m | 13m | 14m | 15m | 16m | 17m | 18m | 19m | 20m | 21m | 22m | 23m | 24m | 25m | 26m | 27m | 28m | 29m | 30m | 31m | 32m | 33m | 34m | 35m | 36m | 37m | 38m | 39m | 40m | 41m | 42m | 43m | 44m | 45m | 46m | 47m | 48m | 49m | 50m | 51m | 52m | 53m | 54m | 55m | 56m | 57m | 58m | 59m | 1h | 2h | 3h | 4h | 5h | 6h | 7h | 8h | 9h | 10h | 11h | 12h | 13h | 14h | 15h | 16h | 17h | 18h | 19h | 20h | 21h | 22h | 23h | 1d | 2d | 3d | 4d | 5d | 6d
type: FULL | MINI
type: MARKET | LIMIT | STOP_LOSS | STOP_LOSS_LIMIT | TAKE_PROFIT | TAKE_PROFIT_LIMIT | LIMIT_MAKER | NON_REPRESENTABLE
selfTradePreventionMode: NONE | EXPIRE_TAKER | EXPIRE_MAKER | EXPIRE_BOTH | DECREMENT | NON_REPRESENTABLE
symbolStatus: TRADING | END_OF_DAY | HALT | BREAK | NON_REPRESENTABLE
timeInForce: GTC | IOC | FOK | NON_REPRESENTABLE
pegPriceType: PRIMARY_PEG | MARKET_PEG | NON_REPRESENTABLE
pegOffsetType: PRICE_LEVEL | NON_REPRESENTABLE
newOrderRespType: ACK | RESULT | FULL | MARKET | LIMIT
cancelRestrictions: ONLY_NEW | NEW | ONLY_PARTIALLY_FILLED | PARTIALLY_FILLED
cancelReplaceMode: STOP_ON_FAILURE | ALLOW_FAILURE
orderRateLimitExceededMode: DO_NOTHING | CANCEL_ONLY
stopLimitTimeInForce: GTC | IOC | FOK
side: BUY | SELL
aboveType: STOP_LOSS_LIMIT | STOP_LOSS | LIMIT_MAKER | TAKE_PROFIT | TAKE_PROFIT_LIMIT
aboveTimeInForce: GTC | IOC | FOK
abovePegPriceType: PRIMARY_PEG | MARKET_PEG
abovePegOffsetType: PRICE_LEVEL
belowType: STOP_LOSS | STOP_LOSS_LIMIT | TAKE_PROFIT | TAKE_PROFIT_LIMIT
belowTimeInForce: GTC | IOC | FOK
belowPegPriceType: PRIMARY_PEG | MARKET_PEG
belowPegOffsetType: PRICE_LEVEL
workingType: LIMIT | LIMIT_MAKER
workingPegPriceType: PRIMARY_PEG | MARKET_PEG
workingPegOffsetType: PRICE_LEVEL
pendingPegPriceType: PRIMARY_PEG | MARKET_PEG
pendingPegOffsetType: PRICE_LEVEL
pendingAboveType: STOP_LOSS_LIMIT | STOP_LOSS | LIMIT_MAKER | TAKE_PROFIT | TAKE_PROFIT_LIMIT
pendingAbovePegPriceType: PRIMARY_PEG | MARKET_PEG
pendingAbovePegOffsetType: PRICE_LEVEL
pendingBelowType: STOP_LOSS | STOP_LOSS_LIMIT | TAKE_PROFIT | TAKE_PROFIT_LIMIT
pendingBelowPegPriceType: PRIMARY_PEG | MARKET_PEG
pendingBelowPegOffsetType: PRICE_LEVEL
workingSide: BUY | SELL
workingTimeInForce: GTC | IOC | FOK
pendingType: LIMIT | MARKET | STOP_LOSS | STOP_LOSS_LIMIT | TAKE_PROFIT | TAKE_PROFIT_LIMIT | LIMIT_MAKER
pendingSide: BUY | SELL
pendingTimeInForce: GTC | IOC | FOK
pendingAboveTimeInForce: GTC | IOC | FOK
pendingBelowTimeInForce: GTC | IOC | FOK

KEY="$BINANCE_API_KEY"
SECRET="$BINANCE_SECRET_KEY"

response=$(curl -s -X GET "$URL" \
  -H "X-MBX-APIKEY: $KEY" \
  --data-urlencode "param1=value1")

echo "$response"

# Try all credential locations in order
API_KEY=$(grep '^BINANCE_API_KEY=' ~/.openclaw/secrets.env 2>/dev/null | cut -d= -f2-)
SECRET_KEY=$(grep '^BINANCE_SECRET_KEY=' ~/.openclaw/secrets.env 2>/dev/null | cut -d= -f2-)

# Fallback: search .env in known directories (KEY=VALUE then raw line format)
for dir in ~/.openclaw ~; do
  [ -n "$API_KEY" ] && break
  env_file="$dir/.env"
  [ -f "$env_file" ] || continue

  # Read first two lines
  line1=$(sed -n '1p' "$env_file")
  line2=$(sed -n '2p' "$env_file")

  # Check if lines contain '=' indicating KEY=VALUE format
  if [[ "$line1" == *=* && "$line2" == *=* ]]; then
    API_KEY=$(grep '^BINANCE_API_KEY=' "$env_file" 2>/dev/null | cut -d= -f2-)
    SECRET_KEY=$(grep '^BINANCE_SECRET_KEY=' "$env_file" 2>/dev/null | cut -d= -f2-)
  else
    # Treat lines as raw values
    API_KEY="$line1"
    SECRET_KEY="$line2"
  fi
done

abc123...xyz
secret123...key

## Binance Accounts

### main
- API Key: abc123...xyz
- Secret: secret123...key
- Testnet: false
- Description: Primary trading account

### testnet-dev
- API Key: test456...abc
- Secret: testsecret...xyz
- Testnet: true
- Description: Development/testing

### futures-keys
- API Key: futures789...def
- Secret: futuressecret...uvw
- Testnet: false
- Description: Futures trading account

name	spot
description	Binance Spot request using the Binance API. Authentication requires API key and secret key. Supports testnet, mainnet, and demo.
metadata	{"version":"1.1.0","author":"Binance","openclaw":{"skillKey":"binance-spot","requires":{"bins":["curl","openssl","date"]},"homepage":"https://github.com/binance/binance-skills-hub/tree/main/skills/binance/spot/SKILL.md"}}
license	MIT

Endpoint	Description	Required	Optional	Authentication
`/api/v3/exchangeInfo` (GET)	Exchange information	None	symbol, symbols, permissions, showPermissionSets, symbolStatus	No
`/api/v3/ping` (GET)	Test connectivity	None	None	No
`/api/v3/time` (GET)

name	spot
description	Binance Spot request using the Binance API. Authentication requires API key and secret key. Supports testnet, mainnet, and demo.
metadata	{"version":"1.1.0","author":"Binance","openclaw":{"skillKey":"binance-spot","requires":{"bins":["curl","openssl","date"]},"homepage":"https://github.com/binance/binance-skills-hub/tree/main/skills/binance/spot/SKILL.md"}}
license	MIT

Endpoint	Description	Required	Optional	Authentication
`/api/v3/exchangeInfo` (GET)	Exchange information	None	symbol, symbols, permissions, showPermissionSets, symbolStatus	No
`/api/v3/ping` (GET)	Test connectivity	None	None	No
`/api/v3/time` (GET)

spot

Options d'installation

Vérifiez les fichiers source

Binance Spot Skill

Quick Reference

Binance Spot Skill

Quick Reference

Parameters

Common Parameters

Enums

Authentication

Security

Share Credentials

Never Disclose API Key and Secret

Never Display Full Secrets

Listing Accounts

Transactions in Mainnet

Binance Accounts

main

testnet-dev

TOOLS.md Structure

Agent Behavior

Adding New Accounts

Signing Requests

New Client Order ID

User Agent Header

spot

Informations de source

Options d'installation

Vérifiez les fichiers source

Plus depuis ce dépôt

Plus depuis ce dépôt

Binance Spot Skill

Quick Reference

Binance Spot Skill

Quick Reference

Parameters

Common Parameters

Enums

Authentication

Security

Share Credentials

Never Disclose API Key and Secret

Never Display Full Secrets

Listing Accounts

Transactions in Mainnet

Binance Accounts

main

testnet-dev

TOOLS.md Structure

Agent Behavior

Adding New Accounts

Signing Requests

New Client Order ID

User Agent Header