WHALE ENGINE
Documentation

Recherche de symboles

Utilisez --search-symbol pour vérifier qu’une paire est disponible avant d’exécuter une stratégie.

Cette commande est autonome et ne nécessite pas de fichier de stratégie.

whale-e --search-symbol <query> [--exchange name] [--limit N] [--exact] [--json] [--json-pretty]

Vous pouvez utiliser directement la forme courte suivante :

whale-e --search-symbol btc

Options

OptionDescription
--search-symbol QUERYObligatoire. Texte recherché (par exemple btc, btcusdt, ethusd).
--exchange NAMELimite la recherche à un exchange. Valeurs supportées : binance, kucoin, bitget, bybit, okx.
--limit NLimite le nombre de résultats affichés. Valeur par défaut : 20.
--exactNe conserve que les correspondances exactes sur les identifiants symbole/ticker.
--jsonRetourne une sortie JSON structurée sur stdout.
--json-prettyActive le formatage lisible du JSON. Nécessite --json.

La recherche est insensible à la casse et normalise l’entrée en supprimant les caractères non alphanumériques.

Sortie texte

Par défaut, la sortie est lisible en console.

whale-e --search-symbol btcusdt --exchange binance --limit 3

Exemple de sortie :

Found 12 matching symbol(s); showing 3.
1. BINANCE:BTCUSDT [spot] ticker=BTCUSDT
2. BINANCE:BTCUSDT.P [usdm_futures] ticker=BTCUSDT
3. BINANCE:BTCUSD.P [coinm_futures] ticker=BTCUSD

Si aucun symbole ne correspond :

No symbols matched query 'foo'.

Sortie JSON

Activez la sortie JSON avec --json.

whale-e --search-symbol btc --json

Le payload de succès utilise _schema: "whale-e.symbol-search.v1".

  • success: true
  • mode: "search_symbol"
  • query, exact, limit, total_matches
  • exchange_filter uniquement quand --exchange est défini
  • results[] avec rank, exchange, symbol, ticker, market_type, score

Le champ score est un score interne de pertinence calcule par le moteur selon les regles de matching exact, prefixe et sous-chaine.

Exemple (tronqué) :

{
  "success": true,
  "_schema": "whale-e.symbol-search.v1",
  "mode": "search_symbol",
  "query": "btc",
  "exact": false,
  "limit": 20,
  "total_matches": 42,
  "results": [
    {
      "rank": 1,
      "exchange": "binance",
      "symbol": "BINANCE:BTCUSDT",
      "ticker": "BTCUSDT",
      "market_type": "spot",
      "score": 850
    }
  ]
}

En mode JSON, les erreurs utilisent l’enveloppe d’erreur CLI standard :

  • success: false
  • _schema: "whale-e.error.v1"
  • mode: "search_symbol"
  • error: { type: string, message: string }

Restrictions

  • --search-symbol ne peut pas être combiné avec --analyze.
  • --search-symbol ne peut pas être combiné avec --export-pinescript.
  • --search-symbol ne peut pas être combiné avec un argument de fichier de stratégie.
  • En mode --search-symbol --json, seule la sous-option --json-pretty est autorisée.
  • En mode recherche, --json-objective-limit et toutes les options --json-include-* sont rejetées.
  • --exchange, --limit et --exact nécessitent --search-symbol.
Préc
Export JSON
Suiv
Bollinger Bands (bb)