Nodavyr agent intelligence

SEC Filing Intelligence Built for AI Agents

Turn SEC filings into structured, machine-readable financial signals your agents can consume and pay for programmatically.

View Agent Quick Start View API Docs

Base Sepolia testnet: $0.10 test USDC per successful intelligence request Keyless x402 or API key Machine-readable JSON

One request. One ranked signal.

From primary filings to a stable agent contract

Nodavyr retrieves SEC company facts and filings, validates comparable financial periods, compares filing language, ranks material changes, and returns concise intelligence.

The compact endpoint exposes the highest-ranked available signal without requiring every agent to recreate the filing-analysis pipeline.

Keyless x402 callers can pay and receive intelligence without first creating a Nodavyr account or API key. Existing API-key access remains supported.

request.json 
GET /v1/agent/AAPL

200 OK
{
  "ticker": "AAPL",
  "signal": "revenue",
  "direction": "positive",
  "confidence": 0.95,
  "score": 90,
  "summary": "Revenue changed +25.00% versus the comparable prior-year quarter.",
  "materiality": "high",
  "request_number": 7
}

Why Nodavyr

Financial disclosure, shaped for software

01

SEC-Derived Intelligence

Convert SEC company facts and filings into ranked financial and filing-change signals.

02

Built for Machines

Predictable JSON designed for applications, workflows, and autonomous agents.

03

Native x402 Payments

When payment enforcement is enabled, compatible agents can receive HTTP 402 requirements, authorize payment, and continue programmatically.

How it works

An agent-native request lifecycle

  1. 01Request /v1/agent/{ticker}
  2. 02Receive HTTP 402 requirements
  3. 03Validate the Base Sepolia payment
  4. 04Authorize $0.10 test USDC through x402
  5. 05Receive Nodavyr intelligence

Keyless mode requires no Nodavyr signup or API key. Callers with an API key may continue to send it for customer/key attribution.

Base Sepolia testnet pricing

Pay for successful intelligence

One concise, ranked result for applications and autonomous agents. No subscription plans are offered yet.

Agent Intelligence

$0.10test USDC / successful request

Base Sepolia only

  • Ranked SEC-derived signal
  • Direction and confidence
  • Signal-specific materiality
  • Concise summary
  • Machine-readable JSON
  • x402 support
  • Persistent usage metering
Try the Agent API

Agent workflow

Call the intelligence layer—not the entire filing stack

Instead of independently retrieving filings, parsing XBRL facts, validating comparable periods, comparing filing text, detecting changes, ranking signals, and determining materiality, an agent can request a compact Nodavyr result.

SEC company facts Comparable periods 10-Q text comparison Signal ranking Agent-ready JSON

Recommended agent path

Start keyless—no signup required

Call the Agent API directly with x402. No Nodavyr account or API key is required for keyless access.

  1. Call GET /v1/agent/AAPL without signing up or sending X-API-Key.
  2. Receive HTTP 402 and inspect the PAYMENT-REQUIRED challenge.
  3. Validate x402 version 2, exact EVM, Base Sepolia, test-USDC asset, 100000 atomic amount ($0.10), and recipient.
  4. Use an x402-compatible client to create the payment with the required payment-identifier.
  5. Retry with PAYMENT-SIGNATURE and receive HTTP 200 JSON intelligence.
export FILINGEDGE_BASE_URL="https://nodavyr.com"

curl --include --fail-with-body \
  "$FILINGEDGE_BASE_URL/v1/agent/AAPL"

This unpaid discovery request exposes PAYMENT-REQUIRED and does not contain a payment. Establish the approved recipient and configuration from the versioned public payment policy, then require the live challenge to match before signing.

Base Sepolia test USDC has no real monetary value. Nodavyr is not yet a mainnet production-payment offering.

Never blindly sign a 402 challenge. Enforce your own network, asset, amount, and recipient policy before authorizing payment. Keep private keys in secure environment or secret management; Nodavyr never needs a buyer's private key.

Explore the interactive API documentation →
Read the machine-readable OpenAPI schema →
Read the autonomous-agent discovery guide →

If paid delivery is interrupted, do not repeat the purchase. The executable Node quick-start and recovery guide privately retains the payment identifier and provides a separate recovery command that never submits another payment.

The HTTP 402 challenge also advertises Bazaar extension metadata for machine discovery.

Optional API-key access

Create an API credential for attributed usage

Signup is not required for keyless x402. Create an API key when you want customer/key attribution and authenticated access to GET /v1/usage. The plaintext key is displayed once—save it securely.

Trust and methodology

Primary SEC data. Deterministic analysis.

Nodavyr retrieves company identifiers, submissions, SEC Company Facts/XBRL data, and filing documents from SEC endpoints. Financial signals use validated year-over-year quarterly comparisons. Filing-language signals compare phrase frequencies in the two latest available 10-Q filings.

The current request pipeline uses deterministic local analysis rather than making an LLM inference request for every API call. Results depend on SEC availability, reporting conventions, company-specific tagging, amendments, and filing quality.

Important information

Nodavyr provides informational, SEC-derived analytical data. Results may be incomplete, delayed, or incorrect and do not constitute investment, legal, accounting, or tax advice. Nodavyr does not guarantee investment outcomes.