AgentToll .well Known API

openapi: 3.2.0
info:
  title: agenttoll.dev .well Known API
  version: 0.13.0
  description: Public metadata endpoints for agenttoll.dev, an x402 paid-work service on Base USDC.
servers:
- url: https://agenttoll.dev
tags:
- name: .well Known
paths:
  /.well-known/mcp.json:
    get:
      summary: Get MCP discovery manifest
      responses:
        '200':
          description: MCP URL, tool roster, x402 auth mode, and discovery links.
          content:
            application/json:
              schema:
                type: object
      tags:
      - .well Known
      operationId: getWellKnownMcpJson
      x-operation-id-source: derived
  /.well-known/agent.json:
    get:
      summary: Get agent discovery metadata
      responses:
        '200':
          description: Agent discovery document with MCP URL, payment metadata, and tools.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    oneOf:
                    - type: array
                    - type: object
                  cached:
                    type: boolean
                  meta:
                    type: object
                    properties:
                      count:
                        type: integer
                      source:
                        type: string
                      generated_at:
                        type: string
                        format: date-time
      tags:
      - .well Known
      operationId: getWellKnownAgentJson
      x-operation-id-source: derived
x-tollbooth-payments:
  protocol: x402
  scheme: exact
  network: eip155:8453
  network_name: Base mainnet
  asset: USDC
  asset_contract: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
  facilitator: https://api.cdp.coinbase.com/platform/v2/x402
  seller: '0x62a0D3d9DF0dE8804983009949c714EaeAFd87F1'
x-tollbooth-tools:
- name: scrape
  price_usd: '0.01'
  description: Fetch a URL and return title, description, meta tags, headings, links, text, and tech signals.
  input:
    url: string, include https://
  example:
    url: https://example.com
- name: detect_stack
  price_usd: '0.02'
  description: Fingerprint a URL for framework, analytics, hosting, payment, CRM, and site-platform signals.
  input:
    url: string, include https://
  example:
    url: https://stripe.com
- name: extract_contacts
  price_usd: '0.02'
  description: Extract visible emails, phone-like strings, social links, and contact/about/pricing/careers URLs from a page.
  input:
    url: string, include https://
  example:
    url: https://example.com
- name: score_lead
  price_usd: '0.03'
  description: Score a company domain for outbound fit using HTTPS, DNS, tech stack, contact paths, social links, platform, and copy depth.
  input:
    domain: string, example stripe.com
  example:
    domain: stripe.com
- name: check_agent_policy
  price_usd: '0.01'
  description: Check robots.txt, llms.txt, security.txt, and agent.json for crawl/discovery signals before an agent touches a site.
  input:
    domain: string, example example.com
  example:
    domain: example.com
- name: find_agent_resource
  price_usd: '0.01'
  description: Search a small curated atlas of agent-useful APIs, self-hosted tools, payment rails, scraping helpers, and automation primitives.
  input:
    query: string
    category: optional string
  example:
    query: open source CRM
    category: sales
- name: validate_agent_manifest
  price_usd: '0.03'
  description: Validate an agent manifest for required identity, endpoint, tools, pricing, and payment fields.
  input:
    manifest_json: JSON string
  example:
    manifest_json: '{...}'
- name: enrich_lead
  price_usd: '0.05'
  description: Enrich a company domain with site metadata, tech stack, social links, DNS, platform cues, and contact links.
  input:
    domain: string, example stripe.com
  example:
    domain: stripe.com
- name: x402_market_radar
  price_usd: '0.05'
  description: 'CDP Bazaar radar for x402 builders: live catalog size, AgentToll ranks, keyword gaps, vertical competition, price samples, and next actions.'
  input:
    query_limit: optional integer 3-20; default 15
  example:
    query_limit: 15
- name: x402_rank_audit
  price_usd: '0.10'
  description: Audit one x402 resource across buyer keywords. Returns Bazaar rank, competitors above it, metadata defects, and fixes that can improve paid-resource discovery.
  input:
    resource: optional resource URL
    keywords: optional string array, max 8
    limit: optional integer 5-25
  example:
    resource: https://agenttoll.dev/paid/x402/market-radar
    keywords:
    - x402 market radar
    - CDP Bazaar ranking
- name: mcp_safety_brief
  price_usd: '0.10'
  description: Static risk brief for an MCP server, OpenAPI spec, or tool manifest before an agent connects it. Returns tool risk, PII and credential hints, allowlist advice, approval policy, and a user-facing safety line.
  input:
    server_url: optional reference URL; not fetched
    openapi_url: optional reference URL; not fetched
    openapi_json: optional pasted OpenAPI object or JSON string to analyze
    manifest_json: optional MCP manifest object or JSON string
    tool_schema: optional tool schema object or JSON string
    intended_task: optional user task
    sensitive_context: optional boolean
    max_tools: optional integer 1-25
  example:
    openapi_json:
      openapi: 3.1.0
      paths:
        /messages:
          post:
            summary: Send message
            requestBody:
              content:
                application/json:
                  schema:
                    type: object
                    properties:
                      email:
                        type: string
                      message:
                        type: string
    intended_task: send a support message
    sensitive_context: true
- name: x402_seller_readiness_audit
  price_usd: '0.10'
  description: Audit whether a paid x402 route is ready for agent buyers. Checks discovery metadata, price visibility, Base USDC terms, seller wallet, receipt language, tool descriptions, and approval copy.
  input:
    resource_url: optional reference URL; not fetched
    openapi_url: optional reference URL; not fetched
    openapi_json: optional pasted OpenAPI object or JSON string
    agent_json: optional agent manifest object or JSON string
    expected_price: optional number or string
    seller_address: optional 0x seller wallet
    route_metadata: optional route metadata object or JSON string
  example:
    resource_url: https://agenttoll.dev/paid/x402/market-radar
    expected_price: '0.05'
    seller_address: '0x62a0D3d9DF0dE8804983009949c714EaeAFd87F1'
    route_metadata:
      protocol: x402
      network: eip155:8453
      asset: USDC
      receipt_schema: agenttoll.receipt.v1
- name: mcp_approval_pack
  price_usd: '0.05'
  description: Generate the approval prompt and spend policy an agent should show before using a paid or risky tool. Returns maxPayment, seller checks, risk reasons, allowed fields, and what not to send.
  input:
    tool_name: optional tool name
    route_url: optional route URL
    price_usd: optional number or string
    task_intent: optional user task
    max_payment_usd: optional number or string
    tool_schema: optional tool schema object or JSON string
    method: optional HTTP method
    seller_address: optional 0x seller wallet
  example:
    tool_name: x402_market_radar
    route_url: https://agenttoll.dev/paid/x402/market-radar
    price_usd: '0.05'
    task_intent: check x402 market demand
    max_payment_usd: '0.05'
    tool_schema:
      name: x402_market_radar
      description: Return an x402 catalog and ranking brief for agent buyers.
      properties:
        query_limit:
          type: integer
    seller_address: '0x62a0D3d9DF0dE8804983009949c714EaeAFd87F1'
- name: insider_cluster_brief
  price_usd: '0.10'
  description: 'Turn recent SEC Form 4 filings into an insider-activity brief: clustered companies, filing counts, source links, and watchlist verdict. Signal intel only.'
  input:
    ticker: optional stock ticker
    limit: optional integer 5-80
  example:
    ticker: AAPL
    limit: 30
- name: gov_contract_fit_brief
  price_usd: '0.15'
  description: Find federal contract awards that fit a service keyword, agency, or company domain. Returns scored incumbents, buyer agencies, dollar amounts, and pursuit notes.
  input:
    keyword: service or market keyword
    agency: optional agency
    company_domain: optional company domain
    limit: optional integer 5-50
  example:
    keyword: cybersecurity training
    agency: Department of Defense
- name: regulatory_impact_brief
  price_usd: '0.12'
  description: Summarize fresh Federal Register and rulemaking signals for one sector. Returns severity, source links, agency context, and a plain action read.
  input:
    sector: crypto, ai, banking, healthcare, energy, privacy, or custom phrase
    agency: optional agency
    hours: optional integer 6-720
  example:
    sector: crypto
    hours: 72
- name: polymarket_event_scan
  price_usd: '0.03'
  description: Scan one live Polymarket negRisk event for fee-adjusted outcome-sum violations.
  input:
    slug: Polymarket event slug
    min_edge: optional decimal, default 0.02
    min_liquidity: optional USD, default 1000
  example:
    slug: democratic-presidential-nominee-2028
    min_edge: '0.02'
    min_liquidity: '1000'
- name: polymarket_market_scan
  price_usd: '0.05'
  description: Scan high-volume active Polymarket markets for resolution candidates and fee-adjusted YES+NO bundle violations.
  input:
    limit: optional integer 10-200
    min_certainty: optional decimal, default 0.95
    min_edge: optional decimal, default 0.02
  example:
    limit: '100'
    min_certainty: '0.95'
    min_edge: '0.02'
- name: cross_platform_arb_scan
  price_usd: '0.10'
  description: Match live Polymarket and Kalshi markets for a topic, compare complementary top-of-book asks, and report fee-adjusted cross-platform spread candidates.
  input:
    query: required topic, entity, or asset
    min_similarity: optional decimal, default 0.62
    min_net_edge: optional decimal, default 0.015
    kalshi_max_pages: optional integer 1-20
  example:
    query: bitcoin
    min_similarity: '0.62'
    min_net_edge: '0.015'
    kalshi_max_pages: '12'
- name: rebalance_arb_scan
  price_usd: '0.04'
  description: 'Scan Polymarket for single-market rebalance arbitrage: YES+NO pricing violations where guaranteed profit exists. Returns long and short opportunities with confidence scores.'
  input:
    limit: optional, default 500, max 2000
    min_edge: optional decimal, default 0.005
    min_liquidity: optional integer, default 1000
  example:
    limit: 500
    min_edge: 0.005
- name: trending_markets
  price_usd: '0.02'
  description: Get top trending Polymarket markets by 24h volume. Includes current prices, liquidity, and volume data. Perfect for market discovery and signal generation.
  input:
    limit: optional, default 20, max 100
    category: optional, e.g. politics, sports, crypto
  example:
    limit: 20
- name: odds_feed
  price_usd: '0.02'
  description: Normalized live odds across Polymarket and Kalshi in a single JSON response. YES/NO prices, spreads, volume, and liquidity for cross-platform comparison.
  input:
    limit: optional, default 30, max 100
    platform: 'optional: polymarket, kalshi, or both (default)'
  example:
    limit: 30
    platform: both
- name: volume_analytics
  price_usd: '0.03'
  description: Top Polymarket markets ranked by 24h volume with liquidity, total volume, current price, and 24h price change. Market momentum and flow analytics.
  input:
    limit: optional, default 30, max 100
    min_volume: optional integer, default 1000
  example:
    limit: 30
    min_volume: 5000
- name: resolution_history
  price_usd: '0.03'
  description: Recently resolved Polymarket markets with final outcomes, resolution dates, and volumes. Essential for backtesting strategies and model calibration.
  input:
    limit: optional, default 30, max 100
    days_back: optional integer, default 7
  example:
    limit: 30
    days_back: 7
- name: kalshi_markets
  price_usd: '0.02'
  description: Live Kalshi market list with bid/ask spreads, volume, open interest, and close dates. CFTC-regulated prediction market data for agents.
  input:
    limit: optional, default 30, max 100
    category: optional event ticker filter
  example:
    limit: 30
- name: agent_threat_intel
  price_usd: '0.03'
  description: Query the OWASP Agentic Top 10 threat catalog (ASI01-ASI10). Returns threats, detection hints, mitigations, and mapped agent-security rule IDs. CC BY-SA 4.0 (OWASP derivative).
  input:
    category: 'optional: e.g. ''prompt injection'', ''supply chain'''
    id: 'optional: e.g. ASI04'
    severity: 'optional: critical, high, medium'
  example:
    category: supply chain
- name: mcp_supply_chain_iocs
  price_usd: '0.02'
  description: Query known-malicious MCP packages, versions, C2 hosts, and email IOCs. Updated as new supply-chain incidents break. The virus database for MCP.
  input:
    package: optional npm package name to check, e.g. postmark-mcp
    host: optional C2 host/domain substring to check, e.g. giftshop.club
  example:
    package: postmark-mcp
- name: agent_trifecta_score
  price_usd: '0.05'
  description: 'Score an agent''s lethal trifecta risk: private data + untrusted content + outbound actions. Returns risk level, missing controls, and decomposition advice. Based on Simon Willison / CSA methodology.'
  input:
    has_private_data: boolean
    has_untrusted_content: boolean
    has_outbound_actions: boolean
    compensating_controls: array of control names
  example:
    has_private_data: true
    has_untrusted_content: true
    has_outbound_actions: true
    compensating_controls:
    - redact_secrets
    - smart_approvals
- name: agent_security_policies
  price_usd: '0.05'
  description: Get drop-in agent security policy templates by profile (coding-agent, browser-agent, payment-agent, research-agent). YAML-style rules with conditions and actions. MIT/CC BY-SA.
  input:
    profile: 'optional: coding-agent, browser-agent, payment-agent, research-agent'
  example:
    profile: payment-agent
- name: geo_intervention_pulse
  price_usd: '0.05'
  description: 'Composite geo/military tension signal: GDELT + BBC/AlJazeera RSS + adsb.lol/mil + Polymarket correlation, 60min window, booster math (multi-source + thermal + vessel + mil-aircraft). intervention signal pattern, free sources.'
  input:
    region: 'optional: global, middle_east, ukraine, taiwan; default global'
    min_confidence: optional decimal 0-1 default 0.6
    hours_back: optional 1-72 default 6
    include_thermal: optional bool default true
  example:
    region: middle_east
    min_confidence: '0.7'
    hours_back: '6'
- name: flight_intel
  price_usd: '0.02'
  description: Live military/exec jet intel via adsb.lol v2/mil (community fork of ADS-B Exchange). TEB/VNY/DCA geofencing for M&A meeting proxy, B-52/F-35/E-3/KC-135 notable detection. Free no-key.
  input:
    airport_code: optional e.g. TEB, VNY, DCA, IAD, OPF, DAL, OAK, LAS
    tail_number: optional hex or callsign filter
    hours_back: optional 1-72 default 12
  example:
    airport_code: TEB
    hours_back: '12'
- name: osint_research_pack
  price_usd: '0.04'
  description: 'Research pack literature discovery factory: GDELT + BBC RSS + HN Algolia + Reddit JSON in parallel, 4-layer verification (existence + recency + multi-source corr + allowlist), combined_score ranking. provenance tagged.'
  input:
    topic: required query string
    domains: optional array of domains to filter
    include_sources: 'optional array: gdelt, bbc, hn, reddit, all'
    hours_back: optional 1-720 default 72
  example:
    topic: Iran refinery drone strike
    include_sources: all
    hours_back: '24'
- name: scenario_verdict
  price_usd: '0.05'
  description: 'Scenario engine 3-scenario verdict.json: seed -> entity extract -> escalation score -1..1 -> bear/base/bull probs sum 1.0 -> composite YES prob + fair price hint + key_drivers. Optional GDELT enrichment. For prediction market composite.'
  input:
    seed_text: required raw OSINT snippet text
    market_question: required Polymarket/Kalshi question
    context: optional extra context
  example:
    seed_text: 2x tanker attacked near Hormuz, IRGC speedboats reported...
    market_question: Will oil price exceed $95 by July 20?
- name: weather_bias_score
  price_usd: '0.03'
  description: 'Kalshi weather fix: Open-Meteo archive vs forecast bias, ensemble mean anomaly, ticker mapping HIGHNY/HIGHCHI/HIGHMIA date %y%b%d uppercase, subtitle parser. Replaces hardcoded C:/ student repo with CC BY 4.0 free feed.'
  input:
    city: 'required city code: NYC, CHI, MIA, LA, etc'
    model: optional model hint
    days_back: optional 2-30 default 7
  example:
    city: NYC
    days_back: '7'
- name: supply_chain_stress
  price_usd: '0.03'
  description: 'Port/chokepoint stress composite: CBP BWT gov API + GDELT choke mentions + AIS chokepoint heuristic + BTS/AAR hints, index 0-95. Trade lead 2-5d freight spike per intervention signal math. Free gov no-key.'
  input:
    ports: optional array LAX,NYC,HOU etc
    chokepoints: optional array hormuz, bab-el-mandeb, suez, bosphorus, malacca
  example:
    ports: LAX,NYC
    chokepoints: hormuz,suez
- name: regulatory_pulse
  price_usd: '0.03'
  description: FDA adverse + trials status + USPTO trademark bulk + FCC OET + FAA registry + SEC enforcement — regulatory momentum for bio/tech Polymarkets. SEC Atom + openFDA free no-key.
  input:
    org: 'optional: all, sec, fda, uspto, fcc, faa; default all'
    hours_back: optional 1-720 default 24
  example:
    org: sec
    hours_back: '24'
- name: attention_momentum
  price_usd: '0.02'
  description: 'HN frontpage + Reddit velocity + pypistats/npm/crates hint: momentum_score = vel*0.6 + score/100*0.3 + comments/50*0.1, viral flag. For culture/tech/popularity prediction markets.'
  input:
    query: optional search term
    window: optional 1h,6h,24h default 6h
  example:
    query: Claude Code
    window: 6h
- name: sec_8k_velocity
  price_usd: '0.03'
  description: 'SEC EDGAR 8-K velocity: EFTS full-text + Atom current Atom, 1h spike vs 24h mean >3x. Boost Items 1.05/2.02/5.02. Earnings/merger/legal prediction market lead. 9/sec TokenBucket, CompanyName UA per 17 CFR 200.80.'
  input:
    hours: optional 1-72 default 6
    min_score: optional 0-1
    limit: optional 10-200 default 100
  example:
    hours: '6'
    limit: '100'
- name: fred_surprises
  price_usd: '0.02'
  description: 'FRED no-auth CSV free public-domain rates: DGS10 10Y + DGS2 2Y spread, 10Y-2Y inversion flag, delta scoring. For Kalshi FOMC Fed funds + rates markets. TokenBucket 2/s polite.'
  input:
    days: optional 5-90 default 14
    min_score: optional 0-1
  example:
    days: '14'
- name: treasury_dts
  price_usd: '0.04'
  description: 'Treasury DTS TGA operating_cash_balance free gov public-domain: TGA close $B, d/d delta, deposits/withdrawals enrichment, score by balance <400B stress 0.85 + delta boost. Liquidity / debt-ceiling / SPX direction edge, 2nd upstream deposits_withdrawals.'
  input:
    days: optional 2-30 default 7
    min_score: optional 0-1
  example:
    days: '7'
- name: openrouter_models
  price_usd: '0.02'
  description: OpenRouter model catalog — id, name, context_length, pricing, created. Popular LLM registry snapshot for model routing decisions. Cached 1h, auto-fetched via public API.
  input:
    limit: optional int 10-300 default 100
    min_context: optional int min context length
  example:
    limit: '100'
- name: github_trending
  price_usd: '0.02'
  description: GitHub trending repos — stars >20 + recent push in last 7d, sorted by stars desc, paged. Public GitHub Search API no-key. Momentum proxy for dev tooling / open source virality.
  input:
    limit: optional int 5-50 default 25
    language: optional e.g. TypeScript, Python, Rust
    since_days: optional 1-90 default 7
  example:
    limit: '25'
    language: TypeScript
- name: hn_frontpage
  price_usd: '0.02'
  description: HN frontpage live — Algolia front_page tag, points, comments, author, dwell = points/(age_h+2). Cache 10min. Top stories sorted by dwell score for attention-momentum edge.
  input:
    limit: optional int 5-50 default 30
    min_points: optional int min points
  example:
    limit: '30'
- name: usgs_quake
  price_usd: '0.02'
  description: USGS all-day earthquakes — mag, place, time, tsunami, felt, coords, depth. Public USGS GeoJSON no-key. Disaster / insurance / commodity market tail-risk pulse.
  input:
    limit: optional int 5-200 default 50
    min_mag: optional float e.g. 2.5
  example:
    limit: '50'
    min_mag: '2.5'
- name: openaq_air
  price_usd: '0.02'
  description: OpenAQ air quality — PM2.5/PM10/NO2/O3 readings by city/country, lastUpdated, sensor counts. v3 API + v2 fallback. Env / health / geo pulse + PM market disclaimer.
  input:
    limit: optional int 5-100 default 30
    country: optional ISO country code e.g. US
  example:
    limit: '30'
    country: US
- name: court_opinions
  price_usd: '0.05'
  description: Search US federal court opinions by keyword, court, date via CourtListener (Free Law Project). Keyless public API.
  input:
    query: string search terms
    court: optional e.g. 'scotus', 'ca9'
    days_back: optional int, default 90
  example:
    query: copyright fair use
- name: court_docket
  price_usd: '0.05'
  description: Look up a federal court docket by ID via CourtListener RECAP archive. Parties, filings, dates.
  input:
    docket_id: string docket ID
  example:
    docket_id: '6789012'
- name: federal_register
  price_usd: '0.03'
  description: Search the daily Federal Register — proposed rules, final rules, presidential notices, agency actions.
  input:
    query: string search terms
    agency: optional e.g. 'SEC', 'EPA'
    type: optional 'RULE', 'NOTICE', 'PRORULE'
  example:
    query: climate emissions
    agency: EPA
- name: patents_search
  price_usd: '0.04'
  description: Full-text patent search via Google Patents. Returns titles, assignees, dates, abstracts.
  input:
    query: string patent search terms
    limit: optional int 5-50 default 20
  example:
    query: large language model inference optimization
- name: regulations_search
  price_usd: '0.03'
  description: Search open rulemakings and public dockets. Falls back to Federal Register if no API key configured.
  input:
    query: string search terms
    status: optional e.g. 'open', 'closed'
  example:
    query: net neutrality
- name: search_papers
  price_usd: '0.04'
  description: Search 226M+ academic papers across all fields with AI-ranked relevance via Semantic Scholar Graph API.
  input:
    query: string research query
    limit: optional int 5-50 default 20
  example:
    query: transformer attention mechanisms
- name: search_arxiv
  price_usd: '0.02'
  description: Search arXiv preprints in CS, physics, math, biology. Returns titles, authors, abstracts, categories.
  input:
    query: string search terms
    category: optional e.g. 'cs.CL', 'physics'
    limit: optional int 5-50 default 20
  example:
    query: mixture of experts
    category: cs.LG
- name: search_pubmed
  price_usd: '0.03'
  description: Search 37M+ biomedical papers via NCBI PubMed. Returns PMIDs, titles, authors, journals.
  input:
    query: string biomedical query
    limit: optional int 5-50 default 20
  example:
    query: CRISPR gene therapy clinical trials
- name: clinical_trials
  price_usd: '0.04'
  description: Search 480K+ clinical studies via ClinicalTrials.gov v2. Status, sponsors, phases, results links.
  input:
    query: string trial query
    status: optional e.g. 'RECRUITING', 'COMPLETED'
    limit: optional int 5-50 default 20
  example:
    query: CAR-T cell therapy
    status: RECRUITING
- name: search_openalex
  price_usd: '0.03'
  description: Search 250M+ works via OpenAlex with institution data, bibliometrics, citation counts, open access links.
  input:
    query: string research query
    limit: optional int 5-50 default 20
  example:
    query: carbon capture sequestration
- name: drug_recalls
  price_usd: '0.03'
  description: Search FDA drug/device/food enforcement recalls — severity, classification, recalling firm, product details.
  input:
    query: optional string search terms
    limit: optional int 5-50 default 20
  example:
    query: acetaminophen
- name: adverse_events
  price_usd: '0.04'
  description: Search 20M+ FDA adverse drug event reports via openFDA. Patient outcomes, drugs, reactions.
  input:
    drug: string drug name
    limit: optional int 5-50 default 20
  example:
    drug: aspirin
- name: product_recalls
  price_usd: '0.03'
  description: Search CPSC consumer product recalls via saferproducts.gov — hazards, manufacturers, remedies.
  input:
    query: optional string product search
    limit: optional int 5-50 default 20
  example:
    query: lithium battery
- name: vehicle_recalls
  price_usd: '0.03'
  description: Search NHTSA vehicle recalls by make, model, or VIN. Campaign numbers, defect descriptions, remedies.
  input:
    make: optional e.g. 'Toyota'
    model: optional e.g. 'Camry'
    vin: optional 17-char VIN
  example:
    make: Ford
    model: F-150
- name: drug_labels
  price_usd: '0.03'
  description: Search official FDA drug labels via openFDA — dosage, warnings, contraindications, active ingredients.
  input:
    drug_name: string drug name
    limit: optional int 5-50 default 10
  example:
    drug_name: metformin
- name: wildfires
  price_usd: '0.03'
  description: Active wildfire detections from NASA FIRMS satellites — lat/lon, brightness, confidence, scan time.
  input:
    limit: optional int 10-100 default 50
    region: optional e.g. 'us-west', 'california'
  example:
    region: california
- name: weather_alerts
  price_usd: '0.02'
  description: Active NOAA NWS severe weather alerts — watches, warnings, advisories by state or zone. Event type, urgency, severity.
  input:
    state: optional 2-letter state code e.g. 'CA'
    zone: optional NWS zone ID
  example:
    state: TX
- name: tide_data
  price_usd: '0.03'
  description: NOAA tide predictions and observed water levels for coastal stations. Datums, units, time series.
  input:
    station: optional NOAA station ID e.g. '8443970'
    date: optional YYYYMMDD
  example:
    station: '8443970'
- name: space_weather
  price_usd: '0.02'
  description: NOAA space weather data — solar flares, geomagnetic storms, solar wind speed, Kp index.
  input:
    type: optional 'planetary_k_index', 'solar_wind', 'flare'
    days: optional int 1-7 default 1
  example:
    type: planetary_k_index
- name: water_levels
  price_usd: '0.03'
  description: Real-time USGS river/stream flow and flood data — gauge height, discharge, percentiles by state.
  input:
    state: optional 2-letter state code
    parameter_code: optional USGS param code, default '00060' (streamflow)
  example:
    state: ND
- name: federal_spending
  price_usd: '0.04'
  description: Search $6T+ federal budget by agency, recipient, or keyword via USAspending.gov API. Awards, amounts, locations.
  input:
    agency: optional string e.g. 'Department of Defense'
    recipient: optional string
    limit: optional int 5-50 default 20
  example:
    agency: Department of Defense
- name: national_debt
  price_usd: '0.02'
  description: US national debt to the penny via Treasury FiscalData. Total debt, debt by instrument, fiscal year data.
  input: {}
  example: {}
- name: federal_grants
  price_usd: '0.03'
  description: Search Grants.gov for open federal funding opportunities — agency, eligibility, deadline, award ceiling.
  input:
    query: optional string keyword search
    status: optional 'open', 'forecasted'
    limit: optional int 5-50 default 20
  example:
    query: artificial intelligence research
    status: open
- name: nonprofit_filings
  price_usd: '0.03'
  description: Search nonprofit IRS 990 filings via ProPublica Nonprofit Explorer — revenue, expenses, executive compensation.
  input:
    query: string organization name
    state: optional 2-letter state code
  example:
    query: Gates Foundation
- name: economic_indicators
  price_usd: '0.03'
  description: GDP, CPI, unemployment, trade data via World Bank API. Multi-year time series for any country.
  input:
    country: optional ISO code e.g. 'US'
    indicator: optional e.g. 'NY.GDP.MKTP.CD' (GDP)
  example:
    country: US
    indicator: NY.GDP.MKTP.CD
- name: lobbying_records
  price_usd: '0.04'
  description: Search FEC lobbying disclosure records — lobbyists, clients, amounts, issues lobbied. Via FEC API.
  input:
    lobbyist: optional string name
    client: optional string org name
    year: optional int 4-digit year
  example:
    client: Google
    year: 2024
- name: edgar_filings
  price_usd: '0.03'
  description: Search SEC EDGAR full-text filings by company, form type (10-K, 10-Q, 8-K), or ticker. Returns filing URLs, dates, and descriptions.
  input:
    query: string company name or keyword
    form_type: 'optional: 10-K, 10-Q, 8-K, S-1'
    ticker: optional stock ticker
  example:
    query: Tesla
    form_type: 10-K
- name: insider_trades
  price_usd: '0.03'
  description: SEC Form 4 insider transactions — buy/sell by executives and large shareholders. Returns ticker, transaction type, shares, value, date.
  input:
    ticker: optional stock ticker e.g. AAPL
    limit: optional int 5-50
  example:
    ticker: AAPL
- name: token_stock_quote
  price_usd: '0.03'
  description: Live DEX quotes for tokenized equities — Coinbase B20 stock tokens on Base (NVDAc, METAc, AAPLc, GOOGLc, TSLA, and the rest of the 13-token set). Price, 24h/7d volume, liquidity, FDV per pool.
  input:
    query: string token symbol (NVDAc) or ticker (NVDA)
    limit: optional int 1-10 pools, default 3
  example:
    query: NVDAc
- name: fred_series
  price_usd: '0.02'
  description: FRED economic data series — GDP, CPI, unemployment, interest rates, and 800K+ other economic indicators from the St. Louis Fed.
  input:
    series_id: optional e.g. GDP, UNRATE, DGS10
    limit: optional int 5-100
  example:
    series_id: GDP
- name: combinatorial_arb
  price_usd: '0.06'
  description: Scan Polymarket negRisk events for combinatorial arbitrage across dependency-linked outcomes. Detect mispriced multi-leg bundles.
  input:
    limit: optional integer; number of active events to inspect before filtering for arbitrage, default 20, max 100
  example:
    limit: 20
- name: orderbook_imbalance
  price_usd: '0.04'
  description: Polymarket CLOB orderbook imbalance — top-of-book bid/ask depth ratio, directional pressure signal for any market.
  input:
    token_id: optional Polymarket CLOB token ID for a single market order book
    condition_id: optional Polymarket condition ID; used when available to scope a market
    limit: optional integer; number of active markets to scan when token_id is omitted, default 10, max 50
  example:
    limit: 10
- name: smart_money
  price_usd: '0.05'
  description: Polymarket leaderboard and top trader activity. Track profitable wallets, their current positions, and flow direction.
  input:
    limit: optional int 5-50
    timeframe: 'optional: 7d, 30d, all'
  example:
    timeframe: 30d
- name: cve_search
  price_usd: '0.02'
  description: Search NIST NVD CVE database by keyword, CVE ID, or severity. Returns CVE ID, description, CVSS score, affected products, references.
  input:
    keyword: optional search term
    cve_id: optional e.g. CVE-2024-1234
    severity: 'optional: LOW, MEDIUM, HIGH, CRITICAL'
  example:
    keyword: log4j
- name: company_registry
  price_usd: '0.03'
  description: Search company registries by name. Returns jurisdiction, status, filing history, officers, registered address.
  input:
    query: string company name
    jurisdiction: optional e.g. US, UK, EU
  example:
    query: OpenAI
- name: reddit_search
  price_usd: '0.02'
  description: Search Reddit posts and comments by keyword, subreddit, or sort. Returns titles, scores, comment counts, URLs, top replies.
  input:
    query: string search terms
    subreddit: optional e.g. technology
    sort: 'optional: relevance, hot, new, top'
    limit: optional int 5-50
  example:
    query: AI agents
    sort: hot


# --- truncated at 32 KB (42 KB total) ---
# Full source: https://artifacts.apis.io/agenttoll-dev/openapi/agenttoll-dev-well-known-api-openapi.yml