> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

**Workflow node**

```json
{
  "type": "finnhub-symbol-search",
  "payload": {
    "query": "status:open"
  },
  "children": []
}
```
  **Test with API**

```bash
curl -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"
  }
}'
```

**Use expressions for dynamic values**

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.