Financial Modeling Prep Get Search Symbol
Look up stock ticker symbols and verify their listing across global markets. Chained workflow note: if the user only has a company name, ambiguous ticker, uncertain asset type, or uncertain exchange, first use discovery tools. Typical first steps: fmp_get_search_symbol / fmp_get_search_name for candidate tickers; fmp_get_profile to inspect isEtf, isFund, isAdr, exchange, country, and currency; fmp_get_stable_search_exchange_variants for exchange-specific variants of the same symbol; fmp_get_stable_company_screener to filter by exchange, country, sector, industry, isEtf, isFund, and active status; list tools such as fmp_get_stable_stock_list, fmp_get_stable_etf_list, fmp_get_stable_index_list, fmp_get_stable_forex_list, fmp_get_stable_cryptocurrency_list, and fmp_get_stable_commodities_list. After confirming asset type and market, call quote, fundamentals, charts, news, or other downstream tools; do not treat ETFs, funds, indexes, forex, crypto, or commodities as ordinary stocks.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Each call is charged 1 AE credit.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
limit | number | No | Maximum number of records to return. | — |
query | string | Yes | Enter a company name or ticker symbol to retrieve essential details. | — |
exchange | string | No | FMP exchange code used to filter the results. | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_fmp_get_search_symbol' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"query": "SOX"
}
}'[
{
"currency": "USD",
"exchange": "NASDAQ",
"exchangeFullName": "NASDAQ",
"name": "iShares Semiconductor ETF",
"symbol": "SOXX"
}
]This example shows part of the response. Copied content is valid JSON.
