Public Company Research Brief
Combine a current market quote with official recent SEC filing and insider-ownership filing metadata in one sourced company brief.
Preview request
The preview path is rate-limited and does not charge. It executes the live source and returns the paid response shape while withholding decision-ready values. Production requests use the same parameters and return a standard x402 challenge when no payment signature is present.
curl --request GET \ "https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/stock_research_brief?preview=true&symbol=NVDA&limit=5"
Input contract
| Parameter | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | US public-company ticker symbol. |
limit | integer | No | Number of recent SEC records per filing group, from 1 to 10. Defaults to 5. |
Example deliverable
This is the documented response shape, not a promise that live values will match the example. The paid request returns current or declared-source results using the same contract.
{
"success": true,
"source": [
"Yahoo Finance chart API",
"SEC EDGAR submissions API"
],
"fetched_at": "2026-08-07T08:16:35.357Z",
"symbol": "AAPL",
"snapshot": {
"price": 312.41,
"previous_close": 333.43,
"change": -21.02,
"change_percent": -6.3042,
"currency": "USD",
"market_state": null,
"recent_filing_count": 10,
"insider_ownership_filing_count": 10
},
"disclosure_signals": {
"latest_filing_form": "10-Q",
"latest_filing_date": "2026-07-31",
"days_since_latest_filing": 7,
"latest_periodic_report_form": "10-Q",
"latest_periodic_report_date": "2026-07-31",
"days_since_periodic_report": 7,
"material_event_filings_last_90d": 1,
"insider_filings_last_90d": 4,
"note": "Counts are taken from the most recent filings requested via the limit parameter, not the issuer's complete history, so raise limit for a wider window. Insider filings are Form 4 submissions; transaction direction and size are inside the linked documents and are not parsed here."
},
"checks_completed": 3,
"checks_requested": 3,
"evidence": {
"quote": {
"success": true,
"source": "Yahoo Finance chart API",
"source_url": "https://finance.yahoo.com/quote/AAPL",
"fetched_at": "2026-08-07T08:16:34.989Z",
"data": {
"symbol": "AAPL",
"exchange": "NasdaqGS",
"currency": "USD",
"price": 312.41,
"previous_close": 333.43,
"open": 314.3399963378906,
"high": 316.2900085449219,
"low": 309.2300109863281,
"volume": 46076800,
"exchange_timezone": "America/New_York"
}
},
"recent_filings": {
"success": true,
"source": "SEC EDGAR submissions API",
"fetched_at": "2026-08-07T08:16:35.357Z",
"company": "Apple Inc.",
"ticker": "AAPL",
"cik": 320193,
"count": 10,
"filings": [
{
"form": "10-Q",
"filed_date": "2026-07-31",
"report_date": "2026-06-27",
"accession_number": "0000320193-26-000020",
"primary_document": "aapl-20260627.htm",
"filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm"
},
{
"form": "8-K",
"filed_date": "2026-07-30",
"report_date": "2026-07-30",
"accession_number": "0000320193-26-000018",
"primary_document": "aapl-20260730.htm",
"filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260730.htm"
}
]
},
"insider_ownership_filings": {
"success": true,
"source": "SEC EDGAR submissions API",
"note": "These are official insider ownership filing records, not parsed trade amounts.",
"fetched_at": "2026-08-07T08:16:35.351Z",
"company": "Apple Inc.",
"ticker": "AAPL",
"count": 10,
"filings": [
{
"form": "4",
"filed_date": "2026-06-17",
"report_date": "2026-06-15",
"accession_number": "0001140361-26-025622",
"primary_document": "xslF345X06/form4.xml",
"filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126025622/xslF345X06/form4.xml"
},
{
"form": "4",
"filed_date": "2026-06-17",
"report_date": "2026-06-15",
"accession_number": "0001140361-26-025620",
"primary_document": "xslF345X06/form4.xml",
"filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126025620/xslF345X06/form4.xml"
}
]
}
},
"unavailable_checks": [],
"caveat": "This brief summarizes public market and SEC filing metadata. It is not investment advice. Disclosure signals describe filing timing and cadence only: insider transaction direction and amounts live inside the linked Form 4 documents and are not parsed here.",
"marketplace_metadata": {
"data_mode": "live_source",
"billable": true,
"availability": "operational",
"source": "Yahoo Finance chart API and SEC EDGAR submissions API"
}
}Purchase decision
Buy when: the active task needs this product's structured result, its declared source and freshness are sufficient, and 0.01 USDC is within the buyer's authorized per-request limit.
Skip when: a cached result is sufficient, the source or fields do not satisfy the task, or the buyer has not authorized payment. Do not bypass wallet, budget, or user-approval policy.
Guaranteed response metadata
Every successful product response identifies how the result was produced. Product-specific output fields are documented in the paid OpenAPI contract. The preview proves the live source and field types without returning the paid values.
{
"marketplace_metadata": {
"data_mode": "live_source",
"billable": true,
"availability": "operational",
"source": "Yahoo Finance chart API and SEC EDGAR submissions API"
}
}Agent payment flow
Fast path: install the public MCP package, configure a dedicated low-balance Base buyer wallet and a maximum per-request spend, then call this tool with auto_pay: true. The client handles the challenge, local signature, settlement, and retry in one tool call.
npx -y dopaminedesk-ai-data-marketplace-mcp
X402_AUTO_PAY=true
X402_EVM_PRIVATE_KEY=<dedicated buyer wallet key>
X402_MAX_PAYMENT_USDC=0.25
tool input: { "auto_pay": true }Manual path: request the product, read the base64 PAYMENT-REQUIRED challenge, sign with any compatible x402 v2 client, and retry with PAYMENT-SIGNATURE. A successful response includes PAYMENT-RESPONSE.