Submit single SEC query

Queries the VLN lattice for factual answers to questions regarding SEC 10-K, 10-Q, and 8-K filings.

post/api/query

Request

  • Base URL: https://financesec.api.caleralabs.com
  • URL: https://financesec.api.caleralabs.com/api/query
  • Auth: API key in header X-License-Key

Request body

querystring required

The natural language query about SEC filings.

target_currencystring

Optional ISO 4217 target currency code (e.g. 'USD') to convert foreign reporting currencies.

currencystring

Alias for target_currency.

usd_onlyboolean

When true, forces response values to be output in USD.

low_tokensboolean

When true, returns compact JSON (MCP and compact REST). Serializer only — not a second engine.

Example request

{
  "query": "WiMi Hologram Cloud Inc. net income 2025",
  "target_currency": "USD",
  "currency": "USD",
  "usd_only": true,
  "low_tokens": true
}

Response

Query response containing grounding results or Refusal metadata

query_idstring
status'VERIFIED_SUCCESS' | 'TENTATIVE_MATCH' | 'SAFE_REFUSAL' | 'EVENT_ACK_PENDING_FACTS' | 'EARNINGS_DAY_EMPTY' | 'OUT_OF_UNIVERSE' | 'SCHEDULE_NOT_IN_ONTOLOGY' | 'FILING_EVENT_SET'

EVENT_ACK_PENDING_FACTS: 8-K Item 2.02 seen; certified metrics pending (see filing_event). EARNINGS_DAY_EMPTY / OUT_OF_UNIVERSE / SCHEDULE_NOT_IN_ONTOLOGY: typed honest silences (UX-SILENCE-TYPED-1). FILING_EVENT_SET: EDGAR-observed earnings-day set recall (Class B).

source'LATTICE_RECALL' | 'ANALYTICAL_GATE' | 'TEMPORAL_GATE' | 'ENTITY_GATE' | 'CONFIDENCE_GATE' | 'FILING_EVENT_GATE' | 'CAPABILITY_GATE' | 'COVERAGE_GATE' | 'ONTOLOGY_GATE'
confidence_scorenumber float
methodstring
reasonstring

Human-readable refusal, typed silence, or pending-facts explanation. EVENT_ACK_PENDING_FACTS and UX-SILENCE-TYPED-1 classes use fixed product copy (not scraped from press HTML).

Example response

{
  "query_id": "q_000181",
  "status": "VERIFIED_SUCCESS",
  "source": "LATTICE_RECALL",
  "coverage": {
    "universe_description": "Cohort0 + active watchlists",
    "universe_size": 12,
    "model_generation": 7,
    "promoted_at": "2026-07-24T15:00:00Z"
  },
  "answer": {
    "value": 1577,
    "unit": "USD",
    "formatted": "$1,577.00"
  },
  "filing_event": {
    "form_type": "8-K",
    "items": [
      "2.02",
      "9.01"
    ],
    "event_type": "earnings_release",
    "event_types": [
      "earnings_release",
      "exhibit_filing"
    ],
    "cik": "0001652044",
    "ticker": "GOOGL",
    "accession": "0001652044-26-000066",
    "filing_date": "2026-07-22",
    "next_check": "companyfacts_or_10q"
  },
  "confidence_score": 1,
  "method": "FuzzyAnswerLookup",
  "provenance": {
    "entity_id": "fin:3M_3M_2018_10K",
    "source_filing": "fin:3M_2018_10K",
    "company": "3M",
    "xbrl_concept": "us-gaap:PaymentsToAcquirePropertyPlantAndEquipment",
    "doc_period": "FY2018",
    "audit_hash": "452b9177...",
    "original_value": "¥1843388870.00 CNY",
    "original_unit": "CNY",
    "fx_rate": "1 CNY = 0.1389 USD",
    "fx_converted": true
  },
  "decomposition": {
    "steps": [
      {
        "label": "Gross Profit",
        "value": "$8,156M"
      }
    ],
    "operator": "÷",
    "result": "12.50%"
  },
  "reason": "No crystallized evidence for this query."
}

Changes

No recorded changes to this operation across all 1 revision of this API.