Skip to content
Eden Engine

Company Financial History (by Ticker & Country)

omnial/equities-dimensions

Given a two-letter country code (e.g. US) and a company's stock ticker (e.g. COIN), returns that company's annual and quarterly revenue, holders revenue, earnings, and basic shares outstanding as dated series -- each a list of [period end date, value] pairs in whole US dollars. Series depth varies by company, and earnings can be negative in loss periods.

activeper callv1
Provider
Web & Business Data Network
Category
equities
Provider price
$0.000819 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": [
    "country",
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "examples": [
        "COIN"
      ],
      "description": "Stock ticker symbol (case-insensitive)"
    },
    "country": {
      "type": "string",
      "examples": [
        "US"
      ],
      "description": "Two-letter country code (ISO 3166-1 alpha-2) for the company, as returned by `GET /equities/v1/companies-list` (case-insensitive)."
    }
  },
  "additionalProperties": false
}
output_schema.json
{
  "type": "object",
  "required": [
    "revenue",
    "holdersRevenue",
    "earnings",
    "basicSharesOutstanding"
  ],
  "properties": {
    "revenue": {
      "type": "object",
      "properties": {
        "annual": {
          "type": "array",
          "items": {
            "type": "array",
            "maxItems": 2,
            "minItems": 2,
            "description": "A [period end date, value] pair.",
            "prefixItems": [
              {
                "type": "string",
                "description": "Period end date in ISO 8601 (YYYY-MM-DD) form."
              },
              {
                "type": "number",
                "description": "The reported value in whole US dollars."
              }
            ]
          },
          "description": "One [period end date, value] pair per fiscal year, newest first. Observed lengths vary by company (7 annual entries for Coinbase; a far deeper history for JPMorgan) -- a short series is the company's short reported history, not a truncated response."
        },
        "quarterly": {
          "type": "array",
          "items": {
            "type": "array",
            "maxItems": 2,
            "minItems": 2,
            "description": "A [period end date, value] pair.",
            "prefixItems": [
              {
                "type": "string",
                "description": "Period end date in ISO 8601 (YYYY-MM-DD) form."
              },
              {
                "type": "number",
                "description": "The reported value in whole US dollars."
              }
            ]
          },
          "description": "One [period end date, value] pair per fiscal quarter, newest first (26 quarterly entries for Coinbase)."
        }
      },
      "description": "Reported revenue by period. Never observed negative in either captured fixture.",
      "additionalProperties": true
    },
    "earnings": {
      "type": "object",
      "properties": {
        "annual": {
          "type": "array",
          "items": {
            "type": "array",
            "maxItems": 2,
            "minItems": 2,
            "description": "A [period end date, value] pair.",
            "prefixItems": [
              {
                "type": "string",
                "description": "Period end date in ISO 8601 (YYYY-MM-DD) form."
              },
              {
                "type": "number",
                "description": "The reported value in whole US dollars."
              }
            ]
          },
          "description": "One [period end date, value] pair per fiscal year, newest first."
        },
        "quarterly": {
          "type": "array",
          "items": {
            "type": "array",
            "maxItems": 2,
            "minItems": 2,
            "description": "A [period end date, value] pair.",
            "prefixItems": [
              {
                "type": "string",
                "description": "Period end date in ISO 8601 (YYYY-MM-DD) form."
              },
              {
                "type": "number",
                "description": "The reported value in whole US dollars."
              }
            ]
          },
          "description": "One [period end date, value] pair per fiscal quarter, newest first."
        }
      },
      "description": "Reported earnings by period. Regularly negative in loss periods -- observed negative for Coinbase's fiscal-2022 annual earnings -- and a negative value is meaningful data, not an error.",
      "additionalProperties": true
    },
    "holdersRevenue": {
      "type": "object",
      "properties": {
        "annual": {
          "type": "array",
          "items": {
            "type": "array",
            "maxItems": 2,
            "minItems": 2,
            "description": "A [period end date, value] pair.",
            "prefixItems": [
              {
                "type": "string",
                "description": "Period end date in ISO 8601 (YYYY-MM-DD) form."
              },
              {
                "type": "number",
                "description": "The reported value in whole US dollars."
              }
            ]
          },
          "description": "One [period end date, value] pair per fiscal year, newest first."
        },
        "quarterly": {
          "type": "array",
          "items": {
            "type": "array",
            "maxItems": 2,
            "minItems": 2,
            "description": "A [period end date, value] pair.",
            "prefixItems": [
              {
                "type": "string",
                "description": "Period end date in ISO 8601 (YYYY-MM-DD) form."
              },
              {
                "type": "number",
                "description": "The reported value in whole US dollars."
              }
            ]
          },
          "description": "One [period end date, value] pair per fiscal quarter, newest first."
        }
      },
      "description": "A second reported revenue line labeled 'holders revenue' by the upstream dataset. Its exact definition is not established from the captured fixtures; it was observed with a much shorter reported history than revenue (1 annual and 2 quarterly entries for Coinbase).",
      "additionalProperties": true
    },
    "basicSharesOutstanding": {
      "type": "object",
      "properties": {
        "annual": {
          "type": "array",
          "items": {
            "type": "array",
            "maxItems": 2,
            "minItems": 2,
            "description": "A [period end date, value] pair.",
            "prefixItems": [
              {
                "type": "string",
                "description": "Period end date in ISO 8601 (YYYY-MM-DD) form."
              },
              {
                "type": "number",
                "description": "The share count, whole shares."
              }
            ]
          },
          "description": "One [period end date, share count] pair per fiscal year, newest first."
        },
        "quarterly": {
          "type": "array",
          "items": {
            "type": "array",
            "maxItems": 2,
            "minItems": 2,
            "description": "A [period end date, value] pair.",
            "prefixItems": [
              {
                "type": "string",
                "description": "Period end date in ISO 8601 (YYYY-MM-DD) form."
              },
              {
                "type": "number",
                "description": "The share count, whole shares."
              }
            ]
          },
          "description": "One [period end date, share count] pair per fiscal quarter, newest first."
        }
      },
      "description": "Basic shares outstanding per period -- a share count, not a dollar value.",
      "additionalProperties": true
    }
  },
  "description": "Four financial dimension series for the requested company, as returned at the result path. Values are whole US dollars except basicSharesOutstanding, which is a share count.",
  "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.000819
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 30, 2026