Search Symbols
Search Finnhub for securities (stocks, ETFs, crypto) by company name or ticker. Returns matching symbols with their display symbol, description, and type, best match first (default 10, max 50). Ideal for: resolving a company name to a ticker before fetching quotes/news/financials, ticker autocomplete.
Catalog action Blockchain Data
Search Finnhub for securities (stocks, ETFs, crypto) by company name or ticker. Returns matching symbols with their display symbol, description, and type, best match first (default 10, max 50). Ideal for: resolving a company name to a ticker before fetching quotes/news/financials, ticker autocomplete.
At a Glance
| Field | Value |
|---|---|
| Action ID | finnhub-symbol-search |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | finnhub, stock, search, research, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Free-text search, e.g. 'apple', 'coinbase', 'COIN', 'bitcoin'. Resolves names or tickers to symbols. |
limit | number | No | Maximum number of matches to return. Range: 1-50. Default: 10. |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
query | string | Yes | The query that was searched |
results | array | Yes | Matched securities, best match first |
count | number | Yes | Number of matches returned |
Examples
json{ "type": "finnhub-symbol-search", "payload": { "query": "status:open" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/finnhub-symbol-search/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "query": "status:open" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.