HKUDS/Vibe-Trading · error · EtoroAPIError

instrument not found for symbol {token!r}

Error message

instrument not found for symbol {token!r}

What it means

Raised by resolve_instrument_id when no lookup variant of the symbol (raw, canonical ticker, alias variants) matched any instrument with positive match priority. The ticker is unknown to eToro.

Source

Thrown at agent/src/trading/connectors/etoro/instruments.py:328

        for item in _search_by_symbol(cfg, lookup, limit=25):
            instrument_id = _instrument_id(item)
            if instrument_id is None:
                continue
            priority = _match_priority(item, lookup, canonical, token)
            if priority > 0:
                candidates.append((priority, instrument_id))

    if not candidates:
        for item in _search_by_text(cfg, canonical, limit=25):
            instrument_id = _instrument_id(item)
            if instrument_id is None:
                continue
            priority = _match_priority(item, canonical, canonical, token)
            if priority > 0:
                candidates.append((priority, instrument_id))

    if not candidates:
        raise EtoroAPIError(f"instrument not found for symbol {token!r}")

    candidates.sort(key=lambda pair: (-pair[0], pair[1]))
    return candidates[0][1]


def get_instrument_metadata(
    instrument_ids: list[int] | tuple[int, ...],
    config: EtoroConfig | None = None,
) -> dict[str, Any]:
    """Fetch display metadata for one or more instrument ids (batch ≤ 50)."""
    from src.trading.connectors.etoro.client import load_config

    cfg = config or load_config()
    ids = [int(i) for i in instrument_ids if int(i) not in _INVALID_INSTRUMENT_IDS and int(i) > 0]
    if not ids:
        raise EtoroAPIError("at least one valid instrument_id is required")
    if len(ids) > 50:
        raise EtoroAPIError("instrumentIds batch limit is 50")

View on GitHub (pinned to 80ffdda44c)

Solutions

1. Verify the ticker with search_instruments(symbol) first
2. Try common variants (drop suffixes like '-USD', remove dots)
3. Check the asset is actually listed on eToro

Example fix

# before
resolve_instrument_id('BTC-USD')
# after
matches = search_instruments('BTC-USD', mode='symbol')
resolve_instrument_id(str(matches[0]['instrumentId']))

matches = search_instruments(symbol, mode='symbol') or search_instruments(symbol, mode='discover')
if not matches:
    raise ValueError(f'{symbol} not listed on eToro')

try:
    iid = resolve_instrument_id(symbol)
except EtoroAPIError as exc:
    if 'not found' in str(exc):
        suggestions = search_instruments(symbol, mode='discover')
        # offer suggestions or fail gracefully
    raise

When it happens

Trigger: resolve_instrument_id('XYZZY') for a ticker eToro doesn't list; delisted symbols; wrong exchange suffix; misspelled ticker passed to get_quote or place_order.

Common situations: Delisted or renamed tickers, OTC symbols not on eToro, user typos, symbols formatted like 'BTC-USD' when eToro expects 'BTCUSD'.

Related errors

• symbol is required
• symbol is required
• Session {session_id} not found
• No current goal
• hypothesis not found: {hypothesis_id}

AI-assisted analysis of HKUDS/Vibe-Trading@80ffdda44c (2026-08-28). Data as JSON: /api/errors/2598d92dd755f33a. Report an issue: GitHub.