Public Company Research Brief

Combine a current market quote with official recent SEC filing and insider-ownership filing metadata in one sourced company brief.

0.20 USDC / request GET live_source Base mainnet x402 v2

Preview request

The preview path is rate-limited and does not charge. 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

ParameterTypeRequiredDescription
symbolstringYesUS public-company ticker symbol.
limitintegerNoNumber of recent SEC records per filing group, from 1 to 10. Defaults to 5.

Guaranteed response metadata

Every successful product response identifies how the result was produced. Product-specific output fields are documented in the paid OpenAPI contract and can be inspected through the preview request where available.

{
  "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.