Skip to content
Eden Engine

Symbol & Company Search (Stocks, ETFs, Funds, Indices)

omnial/search-symbols

Given a search keyword (a ticker symbol or company name, e.g. 'apple' or 'AAPL'), returns matching stocks, ETFs, funds, and indices ranked by relevance, each with its exchange, asset type, category, region, a short company bio, and a live quote (last sale, change, percent change) when the match is a top-level symbol summary. The single best match is also returned separately as `topMatch`. A keyword that matches nothing returns an empty result list rather than an error.

activeper callv1
Provider
Web & Business Data Network
Category
equities
Provider price
$0.01365 per call
Latency p50 / p95
— / —
Success rate
—
Verified
—

Provider list price; Omnial MCP charges provider cost plus a platform markup on top.

Contract

input_schema.json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max results to return."
    },
    "query": {
      "type": "string",
      "description": "Search keyword (symbol or company name)."
    }
  },
  "additionalProperties": false
}
output_schema.json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "results": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "score": {
                "type": "number",
                "description": "Relevance ranking score for this match; higher sorts first."
              },
              "profile": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "The listing's registered name."
                  },
                  "alias": {
                    "type": "string",
                    "description": "Relative path to this listing's page on the vendor's site, e.g. '/market-activity/stocks/aapl'. Not a full URL."
                  },
                  "quote": {
                    "type": "object",
                    "properties": {
                      "change": {
                        "type": "string",
                        "description": "e.g. '-8.24'."
                      },
                      "lastSale": {
                        "type": "string",
                        "description": "e.g. '$319.97'."
                      },
                      "pctChange": {
                        "type": "string",
                        "description": "e.g. '-2.51%'."
                      },
                      "deltaIndicator": {
                        "type": "string",
                        "description": "'up' or 'down'."
                      }
                    },
                    "description": "Present only on the one 'summary' matchType entry observed per symbol in the real fixture; absent on 'dividend'/'earnings'/'historical_quotes' entries for the same symbol.",
                    "additionalProperties": true
                  },
                  "title": {
                    "type": "string",
                    "description": "Listing title as shown on the vendor's site."
                  },
                  "region": {
                    "type": "string",
                    "description": "e.g. 'North America'."
                  },
                  "symbol": {
                    "type": "string",
                    "description": "Ticker symbol, e.g. 'AAPL'."
                  },
                  "category": {
                    "type": "string",
                    "description": "e.g. 'NGS'."
                  },
                  "exchange": {
                    "type": "string",
                    "description": "e.g. 'NASDAQ-GS'."
                  },
                  "industry": {
                    "type": "string",
                    "description": "Observed as an empty string on every real match so far."
                  },
                  "assetType": {
                    "type": "string",
                    "description": "e.g. 'STOCKS'."
                  },
                  "marketCap": {
                    "type": "string",
                    "description": "Formatted market capitalization, e.g. '2,827,023,731,040'."
                  },
                  "matchType": {
                    "type": "string",
                    "description": "Which section of the symbol's profile this entry points to, e.g. 'summary', 'dividend', 'earnings', 'historical_quotes'. Only a 'summary' entry carries a `quote` sub-object in the fixtures observed."
                  },
                  "oldSymbol": {
                    "type": "string",
                    "description": "Previous ticker if the symbol was renamed; observed as an empty string on every real match so far."
                  },
                  "symbolType": {
                    "type": "string",
                    "description": "e.g. 'us'."
                  },
                  "description": {
                    "type": "string",
                    "description": "The company's public profile bio, when available."
                  },
                  "updatedName": {
                    "type": "string",
                    "description": "A shorter display name for the same company, e.g. 'Apple'."
                  },
                  "marketCapValue": {
                    "type": "number",
                    "description": "A numeric market-cap-related figure; its unit/scale is not documented by the vendor and does not line up with `marketCap`'s formatted value in the one real fixture observed (12.4513 vs. a >$2.8T market cap) -- treat as an internal ranking signal, not a reliable dollar figure."
                  },
                  "isAdvertisement": {
                    "type": "boolean",
                    "description": "Whether this entry is a sponsored/placeholder listing."
                  }
                },
                "additionalProperties": true
              },
              "relevancyScore": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Observed as null on every real match in both fixtures; reserved for a secondary relevance metric not yet populated by the vendor."
              },
              "suggestedLabel": {
                "type": "string",
                "description": "Human-readable label for what this match points to, e.g. 'Apple Inc. Common Stock summary' or 'Apple Inc. Common Stock earnings'."
              }
            },
            "additionalProperties": true
          },
          "description": "One entry per matching symbol, ranked by relevance (most relevant first). Empty when the keyword matches nothing (nomatch-empty.json) -- not an error."
        },
        "topMatch": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "score": {
              "type": "number"
            },
            "profile": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "alias": {
                  "type": "string"
                },
                "quote": {
                  "type": "object",
                  "properties": {
                    "change": {
                      "type": "string"
                    },
                    "lastSale": {
                      "type": "string"
                    },
                    "pctChange": {
                      "type": "string"
                    },
                    "deltaIndicator": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                },
                "title": {
                  "type": "string"
                },
                "region": {
                  "type": "string"
                },
                "symbol": {
                  "type": "string"
                },
                "category": {
                  "type": "string"
                },
                "exchange": {
                  "type": "string"
                },
                "industry": {
                  "type": "string"
                },
                "assetType": {
                  "type": "string"
                },
                "marketCap": {
                  "type": "string"
                },
                "matchType": {
                  "type": "string"
                },
                "oldSymbol": {
                  "type": "string"
                },
                "symbolType": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "updatedName": {
                  "type": "string"
                },
                "marketCapValue": {
                  "type": "number"
                },
                "isAdvertisement": {
                  "type": "boolean"
                }
              },
              "additionalProperties": true
            },
            "relevancyScore": {
              "type": [
                "number",
                "null"
              ]
            },
            "suggestedLabel": {
              "type": "string"
            }
          },
          "description": "The single best match, same shape as one `results` entry. Null when the keyword matches nothing (nomatch-empty.json).",
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on both fixtures observed."
    }
  },
  "description": "The search-results record, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}

Pricing

Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.

Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.

ChargeRate
Per call
Flat, regardless of what comes back
$0.01365
Cost basis
Not recorded

This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.

Updated
Sep 15, 2026