OKX ⚫

Que fait OKX ⚫ ?

Échange de crypto-monnaies parmi les 5 premiers mondiaux. Tradez plus de 300 crypto-monnaies avec des fonctionnalités avancées.

Variables d'environnement

Variable	Description	Requise
OKX_API_KEY	Clé API depuis OKX	Oui
OKX_SECRET	Secret API	Oui
OKX_PASSPHRASE	Phrase de passe API	Oui

💎 Configuration du parrainage

Cette compétence utilise un code de parrainage pour percevoir une commission sur les frais de trading.

Variable	Valeur	Description
REFERRAL_CODE	CYBERPAY	Code de parrainage pour le partage des frais

Structure des commissions :

• Jusqu'à 50% des frais de trading en USDT
• Récompenses Mystery Box pour les nouveaux utilisateurs
• Commission à vie sur les utilisateurs parrainés

💡 Les utilisateurs qui s'inscrivent via cette compétence utilisent automatiquement le code de parrainage !

Fonctionnalités

• 📈 Trading Spot - Plus de 300 paires de trading
• 📊 Futures & Perpétuels - Effet de levier jusqu'à 125x
• 🎯 Trading d'Options - Options BTC/ETH
• 💰 Gagner - Staking, épargne, DeFi
• 🔄 Convertir - Échanges de tokens simples
• 🌐 Portefeuille Web3 - Accès DeFi intégré

URL de base de l'API

https://www.okx.com

Authentification

API_KEY="${OKX_API_KEY}"
SECRET="${OKX_SECRET}"
PASSPHRASE="${OKX_PASSPHRASE}"

# Générer la signature
generate_signature() {
  local timestamp="$1"
  local method="$2"
  local path="$3"
  local body="$4"
  local sign_string="${timestamp}${method}${path}${body}"
  echo -n "$sign_string" | openssl dgst -sha256 -hmac "$SECRET" -binary | base64
}

TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")

Obtenir le solde du compte

METHOD="GET"
PATH="/api/v5/account/balance"
SIGNATURE=$(generate_signature "$TIMESTAMP" "$METHOD" "$PATH" "")

curl -s "https://www.okx.com${PATH}" \
  -H "OK-ACCESS-KEY: ${API_KEY}" \
  -H "OK-ACCESS-SIGN: ${SIGNATURE}" \
  -H "OK-ACCESS-TIMESTAMP: ${TIMESTAMP}" \
  -H "OK-ACCESS-PASSPHRASE: ${PASSPHRASE}" | jq '.data[0].details[] | select(.cashBal != "0") | {ccy: .ccy, cashBal: .cashBal, availBal: .availBal}'

Obtenir le prix d'un ticker

INST_ID="BTC-USDT"

curl -s "https://www.okx.com/api/v5/market/ticker?instId=${INST_ID}" | jq '.data[0] | {instId: .instId, last: .last, high24h: .high24h, low24h: .low24h, vol24h: .vol24h}'

Obtenir le carnet d'ordres

curl -s "https://www.okx.com/api/v5/market/books?instId=${INST_ID}&sz=10" | jq '{
  asks: .data[0].asks[:5],
  bids: .data[0].bids[:5]
}'

Passer un ordre spot

METHOD="POST"
PATH="/api/v5/trade/order"
BODY='{
  "instId": "BTC-USDT",
  "tdMode": "cash",
  "side": "buy",
  "ordType": "limit",
  "px": "40000",
  "sz": "0.001"
}'
SIGNATURE=$(generate_signature "$TIMESTAMP" "$METHOD" "$PATH" "$BODY")

curl -s -X POST "https://www.okx.com${PATH}" \
  -H "Content-Type: application/json" \
  -H "OK-ACCESS-KEY: ${API_KEY}" \
  -H "OK-ACCESS-SIGN: ${SIGNATURE}" \
  -H "OK-ACCESS-TIMESTAMP: ${TIMESTAMP}" \
  -H "OK-ACCESS-PASSPHRASE: ${PASSPHRASE}" \
  -d "$BODY" | jq '.'

Passer un ordre au marché

BODY='{
  "instId": "ETH-USDT",
  "tdMode": "cash",
  "side": "buy",
  "ordType": "market",
  "sz": "0.1"
}'
SIGNATURE=$(generate_signature "$TIMESTAMP" "$METHOD" "$PATH" "$BODY")

curl -s -X POST "https://www.okx.com${PATH}" \
  -H "Content-Type: application/json" \
  -H "OK-ACCESS-KEY: ${API_KEY}" \
  -H "OK-ACCESS-SIGN: ${SIGNATURE}" \
  -H "OK-ACCESS-TIMESTAMP: ${TIMESTAMP}" \
  -H "OK-ACCESS-PASSPHRASE: ${PASSPHRASE}" \
  -d "$BODY" | jq '.'

Obtenir les ordres ouverts

METHOD="GET"
PATH="/api/v5/trade/orders-pending"
SIGNATURE=$(generate_signature "$TIMESTAMP" "$METHOD" "$PATH" "")

curl -s "https://www.okx.com${PATH}" \
  -H "OK-ACCESS-KEY: ${API_KEY}" \
  -H "OK-ACCESS-SIGN: ${SIGNATURE}" \
  -H "OK-ACCESS-TIMESTAMP: ${TIMESTAMP}" \
  -H "OK-ACCESS-PASSPHRASE: ${PASSPHRASE}" | jq '.data[] | {instId: .instId, side: .side, px: .px, sz: .sz, state: .state}'

Annuler un ordre

METHOD="POST"
PATH="/api/v5/trade/cancel-order"
BODY='{
  "instId": "BTC-USDT",
  "ordId": "12345678"
}'
SIGNATURE=$(generate_signature "$TIMESTAMP" "$METHOD" "$PATH" "$BODY")

curl -s -X POST "https://www.okx.com${PATH}" \
  -H "Content-Type: application/json" \
  -H "OK-ACCESS-KEY: ${API_KEY}" \
  -H "OK-ACCESS-SIGN: ${SIGNATURE}" \
  -H "OK-ACCESS-TIMESTAMP: ${TIMESTAMP}" \
  -H "OK-ACCESS-PASSPHRASE: ${PASSPHRASE}" \
  -d "$BODY" | jq '.'

Obtenir l'historique des transactions

METHOD="GET"
PATH="/api/v5/trade/fills?instType=SPOT"
SIGNATURE=$(generate_signature "$TIMESTAMP" "$METHOD" "$PATH" "")

curl -s "https://www.okx.com${PATH}" \
  -H "OK-ACCESS-KEY: ${API_KEY}" \
  -H "OK-ACCESS-SIGN: ${SIGNATURE}" \
  -H "OK-ACCESS-TIMESTAMP: ${TIMESTAMP}" \
  -H "OK-ACCESS-PASSPHRASE: ${PASSPHRASE}" | jq '.data[:10] | .[] | {instId: .instId, side: .side, fillPx: .fillPx, fillSz: .fillSz}'

Convertir (Échange simple)

# Obtenir un devis
METHOD="POST"
PATH="/api/v5/asset/convert/estimate-quote"
BODY='{
  "baseCcy": "BTC",
  "quoteCcy": "USDT",
  "side": "buy",
  "rfqSz": "100",
  "rfqSzCcy": "USDT"
}'
SIGNATURE=$(generate_signature "$TIMESTAMP" "$METHOD" "$PATH" "$BODY")

curl -s -X POST "https://www.okx.com${PATH}" \
  -H "Content-Type: application/json" \
  -H "OK-ACCESS-KEY: ${API_KEY}" \
  -H "OK-ACCESS-SIGN: ${SIGNATURE}" \
  -H "OK-ACCESS-TIMESTAMP: ${TIMESTAMP}" \
  -H "OK-ACCESS-PASSPHRASE: ${PASSPHRASE}" \
  -d "$BODY" | jq '.'

Paires de trading populaires

Paire	Description
BTC-USDT	Bitcoin / Tether
ETH-USDT	Ethereum / Tether
SOL-USDT	Solana / Tether
XRP-USDT	XRP / Tether
OKB-USDT	OKB / Tether

Types d'ordres

Type	Description
limit	Ordre limite
market	Ordre au marché
post_only	Ordre post-only
fok	Fill or kill (tout ou rien)
ioc	Immediate or cancel (immédiat ou annuler)

Règles de sécurité

1. TOUJOURS afficher les détails de l'ordre avant exécution
2. VÉRIFIER la paire de trading et le montant
3. CONTRÔLER le solde du compte avant de trader
4. AVERTIR des risques de levier
5. NE JAMAIS exécuter sans confirmation de l'utilisateur

Gestion des erreurs

Code	Cause	Solution
51000	Erreur de paramètre	Vérifier les paramètres
51008	Solde insuffisant	Vérifier le solde
51009	Ordre inexistant	Vérifier l'ID de l'ordre

Liens

• Documentation API OKX
• OKX
• Trading de démonstration