Find Instrument ID

Learn how to resolve a ticker symbol to an eToro Instrument ID.

Most endpoints in the eToro Public API require a numeric instrumentId to identify the asset you wish to access, rather than the text-based ticker symbol (e.g., ‘AAPL’).

To bridge this gap, you must use the Search endpoint to resolve a symbol into its corresponding ID.

The Resolution Process

Resolving a symbol involves sending a specific query to the market data search endpoint and parsing the result to find the matching instrument record.

1. Endpoint

Use the Search endpoint to query for the instrument.

GET https://public-api.etoro.com/api/v1/market-data/search

2. Query Parameters

While the search endpoint accepts general search text, the most precise way to find a specific ID is to filter by the internalSymbolFull field.

Parameter	Value	Description
internalSymbolFull	AAPL	The specific ticker symbol you want to resolve.

3. Header Requirements

Remember to include your authentication headers with every request.

• x-api-key
• x-user-key
• x-request-id

Examples

cURL

curl -X GET "https://public-api.etoro.com/api/v1/market-data/search?internalSymbolFull=AAPL" \
  -H "x-api-key: <YOUR_PUBLIC_KEY>" \
  -H "x-user-key: <YOUR_USER_KEY>" \
  -H "x-request-id: <UUID>"

const symbol = 'AAPL';
const url = `https://public-api.etoro.com/api/v1/market-data/search?internalSymbolFull=${symbol}`;

fetch(url, options)
    .then(res => res.json())
    // Find the exact match in the returned items list
    .then(res => {
        const instrument = res.items.find(i => i.internalSymbolFull === symbol);
        console.log("Instrument ID:", instrument.instrumentId);
    })
    .catch(err => console.error(err));

import requests
import uuid

symbol = "AAPL"
url = "https://public-api.etoro.com/api/v1/market-data/search"

# Use internalSymbolFull to filter specifically for the symbol
params = {
    "internalSymbolFull": symbol
}

headers = {
    "x-api-key": "<YOUR_PUBLIC_KEY>",
    "x-user-key": "<YOUR_USER_KEY>",
    "x-request-id": str(uuid.uuid4())
}

response = requests.get(url, headers=headers, params=params)

if response.status_code == 200:
    data = response.json()
    # Find the exact match in the returned items list
    instrument = next((item for item in data['items'] if item['internalSymbolFull'] == symbol), None)
    
    if instrument:
        print(f"Instrument ID: {instrument['instrumentId']}")
    else:
        print("Instrument not found")
else:
    print(f"Error: {response.status_code}")

Best Practices

1. Verify the Match: The search might return partial matches or related assets. Always verify that the internalSymbolFull property of the returned item exactly matches your requested symbol.

2. Cache your IDs: Instrument IDs are immutable: They never change, even if a company rebrands or changes its ticker symbol. While symbols rarely change, relying on the permanent instrumentId ensures your application remains robust against such events. We strongly recommend fetching these IDs once and caching the mapping (e.g., AAPL -> 1001) locally.