Signal Nodus SEC Filings

Resolve a ticker or CIK to a company's canonical SEC identity: legal name, CIK, industry classification, tickers, and exchanges. Use this first when you only have a ticker and need the CIK for other calls. US SEC registrants only. Free: no key and no payment needed. Use it to verify the service before paying.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Ticker symbol (e.g. AAPL) or SEC CIK number (e.g. 320193)."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

List a company's most recent SEC filings with form type, dates, accession number, and a direct document URL. Optionally filter to one form type (10-K, 10-Q, 8-K, 4, S-1...). Covers EDGAR's recent-filings index, which holds roughly the last 1000 filings; older history is not searched, and the response says so when it exists. This is the canonical filing record, not commentary about it. Costs $0.01 per call. No subscription: present a credit key or a machine payment.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Ticker symbol (e.g. AAPL) or SEC CIK number (e.g. 320193)."
    },
    "form": {
      "type": "string",
      "description": "Optional exact form type filter, e.g. 10-K, 10-Q, 8-K, 4."
    },
    "limit": {
      "type": "integer",
      "description": "How many filings to return (1-50, default 10).",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

The market-wide feed of filings as they land at the SEC, optionally filtered by form type. Built for monitoring agents that poll: the answer is cached for 60 seconds upstream, includes 8-K item codes so a watcher can filter on events, and every entry carries its accession number for pinning. Costs $0.01 per call.

{
  "type": "object",
  "properties": {
    "form": {
      "type": "string",
      "description": "Filter to one form type, e.g. 8-K, 10-K, S-1, 13F-HR. Omit for all."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "description": "Entries to return. Default 20."
    }
  },
  "additionalProperties": false
}

Pull a single numbered item out of a 10-K or 10-Q as clean text: risk factors (1A), MD&A (7), business (1), and the rest. Saves you fetching a multi-megabyte HTML document and finding the section yourself. Pin an exact filing with `accession`; without it you get the most recent filing of that form, and the response warns if a later amendment exists. Failure mode: if a filing's layout hides the item heading, the call errors clearly instead of returning a guessed section. Every response carries accessionNumber, filingDate, source URL, and parserVersion; accuracy is measured on a public golden set (signalnodus.ai/eval). Large cold filings can take several seconds to fetch and parse. Costs $0.05 per call. No subscription: present a credit key or a machine payment.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Ticker symbol (e.g. AAPL) or SEC CIK number (e.g. 320193)."
    },
    "item": {
      "type": "string",
      "description": "Item number, e.g. 1A, 7, 7A. Call with item omitted to list what this filing has."
    },
    "form": {
      "type": "string",
      "description": "10-K or 10-Q. Default 10-K."
    },
    "accession": {
      "type": "string",
      "description": "Exact accession number to pin, e.g. 0000320193-26-000020. Strongly recommended for anything reproducible."
    },
    "max_chars": {
      "type": "integer",
      "minimum": 1000,
      "maximum": 200000,
      "description": "Truncate the section. Default 50000."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

Year-over-year diff of a 10-K risk-factor or MD&A section: the added and removed passages plus a change ratio, so an agent gets what changed instead of two multi-megabyte filings to parse. Pass two accession numbers to pin exactly which filings are compared; otherwise the two most recent of that form are used and the response says which, warning if a later amendment exists. Failure mode: if either section cannot be located or parsed into sentences, the call errors rather than reporting a false 0% change. Diff accuracy and method are published at signalnodus.ai/eval. Two large cold filings can take tens of seconds. Costs $0.50 per call. No subscription: present a credit key or a machine payment.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Ticker symbol (e.g. AAPL) or SEC CIK number (e.g. 320193)."
    },
    "item": {
      "type": "string",
      "description": "Item to compare, e.g. 1A for risk factors. Default 1A."
    },
    "form": {
      "type": "string",
      "description": "10-K or 10-Q. Default 10-K."
    },
    "from_accession": {
      "type": "string",
      "description": "Older filing to compare from."
    },
    "to_accession": {
      "type": "string",
      "description": "Newer filing to compare to."
    },
    "max_passages": {
      "type": "integer",
      "minimum": 5,
      "maximum": 200,
      "description": "Cap on added/removed passages returned. Default 40."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

Deterministic check of a numeric claim against the company's own XBRL as filed with the SEC. Returns supported, contradicted, or unverifiable, with the as-reported value and the accession number to cite. Costs $0.10 per call.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Ticker symbol (e.g. AAPL) or SEC CIK number (e.g. 320193)."
    },
    "concept": {
      "type": "string",
      "description": "XBRL concept, e.g. Revenues or NetIncomeLoss."
    },
    "claimed_value": {
      "type": "number",
      "description": "The value the claim asserts, in the concept's unit."
    },
    "fiscal_year": {
      "type": "integer",
      "description": "Fiscal year of the claim, e.g. 2025."
    },
    "fiscal_period": {
      "type": "string",
      "description": "FY, Q1, Q2, Q3, or Q4. Default FY."
    },
    "end": {
      "type": "string",
      "description": "Alternative to fiscal_year: exact period end date, YYYY-MM-DD."
    },
    "tolerance_pct": {
      "type": "number",
      "description": "Match tolerance in percent. Default 0.5."
    }
  },
  "required": [
    "company",
    "concept",
    "claimed_value"
  ],
  "additionalProperties": false
}

A company's 8-K filings parsed into material events with decoded item codes: executive departures (5.02), restatements (4.02), acquisitions (2.01), cybersecurity incidents (1.05), and the rest. eventDate is when it happened, filedAt when it was disclosed. Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Ticker symbol (e.g. AAPL) or SEC CIK number (e.g. 320193)."
    },
    "item": {
      "type": "string",
      "description": "Optional item-code filter, e.g. 5.02."
    },
    "limit": {
      "type": "integer",
      "description": "Events to return, max 25. Default 10."
    },
    "include_amendments": {
      "type": "boolean",
      "description": "Also include 8-K/A amendments."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

Fetch an as-reported XBRL financial concept for a company across recent periods, each tied to the filing it came from. Note that many issuers report revenue under RevenueFromContractWithCustomerExcludingAssessedTax rather than Revenues; if one returns nothing current, try the other. Costs $0.01 per call. No subscription: present a credit key or a machine payment.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Ticker symbol (e.g. AAPL) or SEC CIK number (e.g. 320193)."
    },
    "concept": {
      "type": "string",
      "description": "US-GAAP concept name.",
      "enum": [
        "Revenues",
        "RevenueFromContractWithCustomerExcludingAssessedTax",
        "NetIncomeLoss",
        "OperatingIncomeLoss",
        "Assets",
        "Liabilities",
        "StockholdersEquity",
        "CashAndCashEquivalentsAtCarryingValue",
        "ResearchAndDevelopmentExpense",
        "EarningsPerShareDiluted"
      ]
    }
  },
  "required": [
    "company",
    "concept"
  ],
  "additionalProperties": false
}

Every 13F manager whose latest information table names the company: manager, CIK, filing date, accession number, plus the total count of reporting managers. The inverse of institutional_holdings; chain them to walk from a ticker to full parsed portfolios. Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Ticker symbol (e.g. AAPL) or SEC CIK number (e.g. 320193)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Managers to return. Default 25."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

An institutional manager's latest 13F-HR parsed and aggregated: top positions by value with shares, CUSIP, and share of portfolio. Works on managers (Berkshire, Bridgewater...), not operating companies. Pinned by accession number. Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Manager name or CIK, e.g. Berkshire Hathaway."
    },
    "top": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Positions to return. Default 20."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

A company's latest Form 4 filings parsed into data: who traded, their role, buy or sell, shares, price, and holdings after. The free EDGAR servers list Form 4s; this one reads them. Every filing pinned by accession number. Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Ticker symbol (e.g. AAPL) or SEC CIK number (e.g. 320193)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Form 4 filings to parse. Default 5."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

Exact-phrase full-text search over every EDGAR filing since 2001. Returns the company, form, date, and accession number of each hit, ready to feed into filing_section or compare_filings. Costs $0.01 per call.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Exact phrase to search for, 2-200 characters."
    },
    "forms": {
      "type": "string",
      "description": "Optional comma list of form types, e.g. 10-K,8-K."
    },
    "from": {
      "type": "string",
      "description": "Optional start date, YYYY-MM-DD."
    },
    "to": {
      "type": "string",
      "description": "Optional end date, YYYY-MM-DD."
    },
    "limit": {
      "type": "integer",
      "description": "Hits to return, max 50. Default 10."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

The first public signal of an activist position: Schedule 13D and 13G beneficial-ownership filings naming a company over a window, newest first. A fresh 13D is where an activist campaign becomes public. Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Ticker symbol (e.g. AAPL) or SEC CIK number (e.g. 320193)."
    },
    "days": {
      "type": "integer",
      "description": "Lookback window in days, 30-730. Default 365."
    },
    "limit": {
      "type": "integer",
      "description": "Filings to return, max 100. Default 25."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

New S-1 and F-1 registration statements as they land at EDGAR, market-wide and newest first: the earliest public signal of a US IPO. Costs $0.01 per call.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Filings to return, max 40. Default 20."
    },
    "include_amendments": {
      "type": "boolean",
      "description": "Also include S-1/A and F-1/A."
    }
  },
  "additionalProperties": false
}

Mechanical rewrite ratio of a filing item year over year: added sentences divided by total sentences in the newer section, as a percent, with a magnitude band. This measures editing activity in the text, not risk and not exposure; a lightly reworded sentence counts as one removal plus one addition. Built on the same sentence-level diff as compare_filings; buy that when you need the passages themselves. Formerly named risk_churn_score, which still answers. Costs $0.10 per call.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Ticker symbol (e.g. AAPL) or SEC CIK number (e.g. 320193)."
    },
    "item": {
      "type": "string",
      "description": "Item identifier. Default 1A (risk factors)."
    },
    "form": {
      "type": "string",
      "description": "10-K or 10-Q. Default 10-K."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): Native balance of any 0x address with block height, from public RPC. Costs $0.01 per call.

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "description": "base or ethereum. Default base."
    },
    "address": {
      "type": "string",
      "description": "0x-prefixed address."
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): Current gas price in wei and gwei with block height. Costs $0.01 per call.

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "description": "base or ethereum. Default base."
    }
  },
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): Status, gas used, effective gas price and log count for a transaction hash. Costs $0.01 per call.

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "description": "base or ethereum. Default base."
    },
    "tx": {
      "type": "string",
      "description": "0x-prefixed transaction hash."
    }
  },
  "required": [
    "tx"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): DEX-aggregated price, FDV, market cap and 24h volume for a token contract. Cached 60s; not an oracle. Costs $0.01 per call.

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "description": "base or ethereum. Default base."
    },
    "token": {
      "type": "string",
      "description": "Token contract address."
    }
  },
  "required": [
    "token"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): ECB reference rates from one base currency to up to ten targets, ISO 4217. Daily fix, not a tradable quote. Costs $0.01 per call.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Base currency. Default USD."
    },
    "to": {
      "type": "string",
      "description": "Comma list of targets. Default EUR."
    }
  },
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): DNS records, SPF presence, registration date and age, registrar, expiry and RDAP status for a hostname, in one call. Costs $0.01 per call.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Bare hostname, e.g. example.com."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): Top-volume Polymarket markets with implied probabilities, optionally filtered by a question substring. Costs $0.01 per call.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Substring filter."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Markets to return. Default 10."
    }
  },
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): Federal prime contract awards to a company from USAspending.gov, largest first: award id, amount, agency, and period. Recipient match is by name text. Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Recipient name, e.g. Lockheed Martin."
    },
    "days": {
      "type": "integer",
      "description": "Lookback window in days, 30-1825. Default 365."
    },
    "limit": {
      "type": "integer",
      "description": "Awards to return, max 25. Default 10."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): US Senate LDA lobbying disclosures for a client company, newest first: registrant, reported income or in-house expenses, and issue areas. Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Client company name, e.g. Apple."
    },
    "year": {
      "type": "integer",
      "description": "Optional filing year filter."
    },
    "limit": {
      "type": "integer",
      "description": "Filings to return, max 25. Default 10."
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): Weekly Commitments of Traders positioning for a futures contract: non-commercial (speculative) and commercial (hedging) longs, shorts and net, net as a share of open interest, and the week-over-week changes. Match by contract name fragment such as CRUDE OIL, WHEAT, GOLD or S&P 500. The disclosed record only, no forecast. Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "description": "Contract name fragment, e.g. CRUDE OIL, WHEAT, GOLD, COPPER, S&P 500."
    },
    "weeks": {
      "type": "integer",
      "description": "Weeks of history per contract, max 26. Default 4."
    }
  },
  "required": [
    "market"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): Official EIA energy figures, newest period first: electricity_price (retail cents per kWh by state and sector), fuel_price (retail gasoline and diesel dollars per gallon by region), grid_demand (hourly demand and day-ahead forecast by balancing authority). Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "series": {
      "type": "string",
      "enum": [
        "electricity_price",
        "fuel_price",
        "grid_demand"
      ],
      "description": "Which EIA series to read."
    },
    "state": {
      "type": "string",
      "description": "Two-letter state code, for electricity_price."
    },
    "sector": {
      "type": "string",
      "description": "RES, COM, IND, TRA or ALL, for electricity_price. Default RES."
    },
    "region": {
      "type": "string",
      "description": "Balancing-authority code such as CISO or ERCO, for grid_demand."
    },
    "limit": {
      "type": "integer",
      "description": "Rows to return, max 100. Default 10."
    }
  },
  "required": [
    "series"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): Official USDA NASS estimates from Quick Stats: yields, production, area planted and harvested, stocks, and prices received, national or by state. Values are as published, including NASS's own suppression markers. Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "commodity": {
      "type": "string",
      "description": "NASS commodity name, e.g. CORN, SOYBEANS, WHEAT, CATTLE."
    },
    "statistic": {
      "type": "string",
      "enum": [
        "YIELD",
        "PRODUCTION",
        "AREA HARVESTED",
        "AREA PLANTED",
        "STOCKS",
        "PRICE RECEIVED"
      ],
      "description": "Statistic category. Default YIELD."
    },
    "year": {
      "type": "string",
      "description": "Four-digit year. Omit for all available."
    },
    "state": {
      "type": "string",
      "description": "Two-letter state code. Omit for national."
    },
    "limit": {
      "type": "integer",
      "description": "Rows to return, max 100. Default 20."
    }
  },
  "required": [
    "commodity"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): Monthly US customs-reported trade value in dollars by trading partner for one HS chapter, from the Census international trade series. Exports are total value, imports are general imports. Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "direction": {
      "type": "string",
      "enum": [
        "exports",
        "imports"
      ],
      "description": "Trade direction. Default exports."
    },
    "hs_code": {
      "type": "string",
      "description": "Two-digit HS chapter, e.g. 87 vehicles, 10 cereals, 27 mineral fuels."
    },
    "year": {
      "type": "string",
      "description": "Four-digit year."
    },
    "month": {
      "type": "string",
      "description": "Month, 01 through 12."
    }
  },
  "required": [
    "hs_code",
    "year",
    "month"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): Inspect one public HTTPS x402 endpoint and report the 402 challenge it returns to an anonymous caller: HTTP status, payment rails (scheme, network, asset, recipient), WWW-Authenticate header, Bazaar discovery extension, and a pass/fail checklist with a health verdict. No payment is signed or submitted. Costs $0.10 per call.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Absolute https URL of the x402 resource, e.g. https://api.example.com/v1/thing"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): One-call market data for an ERC-20 token: price, 24h change, FDV, market cap, 24h volume, supply, pool count, deepest pool liquidity, and factual risk flags (low liquidity, thin volume). GeckoTerminal aggregated DEX data. Not an oracle, not financial advice. Costs $0.10 per call.

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "description": "base, ethereum, or arbitrum. Default base."
    },
    "token": {
      "type": "string",
      "description": "Token contract address (0x...)."
    }
  },
  "required": [
    "token"
  ],
  "additionalProperties": false
}

Experimental (outside the core SEC path; not covered by the published accuracy eval, may change or be withdrawn): Live network fee across Base, Arbitrum, and Ethereum, expressed as the USD cost of a standard native transfer so chains compare on money, with the cheapest chain named. Network fee only, not a route or swap quote. Costs $0.05 per call.

{
  "type": "object",
  "properties": {
    "chains": {
      "type": "string",
      "description": "Comma list from base, arbitrum, ethereum. Default all three."
    }
  },
  "additionalProperties": false
}