{"openapi":"3.1.0","info":{"title":"QuantJourney Agent Query API","summary":"Bounded, evidence-backed QuantJourney agent queries","description":"Canonical discovery contract for currently executable public agent resources.","version":"0.27.2","contact":{"name":"QuantJourney Support","email":"support@quantjourney.cloud","url":"https://quantjourney.cloud"},"x-guidance":"Use POST /v1/query/company-snapshot-lite for Return a free, bounded factual ticker snapshot with price, selected metrics, freshness and explicit coverage gaps. No authentication is required. Use POST /v1/query/earnings-preview for Prepare an evidence-backed earnings preview with consensus, revisions, dispersion, historical surprises, valuation context and explicit review questions. Authenticate with OAuth client_credentials scope agents:query. Use POST /v1/query/earnings-recap for Reconcile the latest reported earnings with consensus, estimate changes, adjusted-close reactions, SPY-adjusted CAR and explicit thesis-review questions. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/congress-gov-signals for Combine congressional disclosures and government-contract evidence with disclosure-lag warnings. Authenticate with OAuth client_credentials scope agents:query. Use POST /v1/query/sec-company-identity for Resolve a ticker or company name to official SEC identity and exchange fields. No authentication is required. Use POST /v1/query/sec-latest-filing for Return the latest official SEC submission for a ticker and bounded form type. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/sec-company-facts-compact for Project selected current SEC XBRL facts into a small evidence envelope. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.02. Use POST /v1/query/gleif-entity-lookup for Resolve an entity name or exact LEI against the official GLEIF index. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/treasury-yield-curve-latest for Return one latest bounded U.S. Treasury par-yield curve observation. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/overnight-rates-latest for Return the latest bounded SOFR, EFFR and related official reference-rate observations. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/sec-filing-delta for Compare selected SEC XBRL facts between the latest two filings of one form type. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.10. Use POST /v1/query/government-demand-packet for Combine bounded award rollups and materialized contract signals for one ticker. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.25. Use POST /v1/query/security-history for Return bounded normalized daily adjusted-close history for one public-equity ticker, with dates, currency, source and freshness. It is not a live quote. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/security-screen for Screen U.S. public companies or a named U.S. index using a small allowlist of precomputed financial metrics. ETFs and funds are excluded; arbitrary SQL is never accepted. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.02. Use POST /v1/query/insider-activity for Return recent official SEC Form 4 filing metadata for one issuer. This version reports filing activity and accessions only; it does not claim parsed purchases, sales or ownership changes. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.02. Use POST /v1/query/short-interest-state for Return bounded official FINRA consolidated short-interest observations and optional Nasdaq Trader Reg SHO threshold-list membership. Semi-monthly short interest is not daily short volume. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.02. Use POST /v1/query/security-technicals for Return latest precomputed technical indicators from an explicit indicator-family allowlist. Use for structured technical state, not a trading signal or live quote. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/market-regime for Return the latest compact market-risk context computed by QJ Analytics from governed Warehouse inputs. It is descriptive evidence, not a forecast or allocation instruction. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.02. Use POST /v1/query/simulate-trade for Estimate before, after and delta portfolio volatility, effective number of bets and fractional risk contribution for one bounded hypothetical long-only trade. No order or portfolio state is created. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.05. Use POST /v1/query/portfolio-normalize for Resolve up to 25 unique long-only tickers and return normalized weights, identity coverage and concentration without creating a stored portfolio. No authentication is required. Use POST /v1/query/portfolio-exposure for Return compact sector, country, asset-class and supplied-currency exposure for an inline portfolio. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-volatility for Estimate bounded annualized volatility from authorized aligned daily prices or returns. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-var-cvar for Calculate bounded portfolio VaR and CVaR from authorized aligned daily prices or returns. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-drawdown for Calculate bounded portfolio and position drawdowns from authorized aligned daily prices or returns. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-benchmark-risk for Estimate portfolio beta, correlation and regression evidence versus one benchmark. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-factor-exposure for Estimate bounded CAPM, Fama-French 3 or Fama-French 5 factor exposure. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-liquidity for Estimate compact position liquidity using observed price-volume history. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-events for Return bounded upcoming-event exposure and event-risk summaries. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-signals for Return compact precomputed technical, congressional and government-contract signals for the largest supplied positions. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-scenario for Run one named or bounded custom QJ Risk scenario over an inline portfolio. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-position-risk for Return compact per-position volatility, beta, correlation and drawdown evidence. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-performance for Calculate whole-portfolio hypothetical constant-weight performance, Sharpe, Sortino and Calmar. Not account TWR/MWR. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-correlations for Calculate the full Pearson or Spearman matrix of aligned daily asset returns; constant-series correlations are null. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-optimization for Calculate stateless long-only fully-invested weights using min_variance, risk_parity or max_sharpe. Research only, no orders or persistence. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Use POST /v1/query/portfolio-simulation for Simulate a constant-weight portfolio with calibrated lognormal GBM or IID historical bootstrap. Seeded, bounded, not a forecast. Authenticate with OAuth client_credentials scope agents:query. Satisfy the advertised x402 Base mainnet payment of $0.01. Send uppercase ticker JSON such as {\"ticker\":\"NVDA\"}. Results are bounded evidence artifacts, not investment recommendations.","x-logo":{"url":"https://agents.quantjourney.cloud/favicon.ico"}},"paths":{"/v1/query/sec-company-identity":{"post":{"tags":["agent-queries","public-data"],"summary":"Free bounded SEC company identity lookup","description":"Resolve a ticker or company name to official SEC identity and exchange fields.","operationId":"sec_company_identity_v1_query_sec_company_identity_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecCompanyIdentityRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryArtifactResponse"}}}},"429":{"description":"Daily free-query limit reached."},"503":{"description":"The bounded MCP query executor is not enabled."},"422":{"description":"Request validation failed with machine-actionable recovery guidance","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/MachineRequestGuidance"}}}}},"security":[],"x-qj-query-id":"sec-company-identity","x-qj-tools":["api.sec.search_companies","api.sec.get_company_submissions"],"x-qj-legal":{"class":"OPEN_WITH_CONDITIONS","sources":["SEC EDGAR"],"notices":["Data provided by the U.S. Securities and Exchange Commission."]},"x-qj-rate-limit":{"requests":10,"window":"P1D","subject":"caller_fingerprint"}},"x-qj-error-recovery":{"methodNotAllowedStatus":405,"validationFailedStatus":422,"correctMethod":"POST","schema":"https://agents.quantjourney.cloud/openapi.json","bodyExample":{"query":"AAPL"}}}},"components":{"schemas":{"QueryArtifactResponse":{"properties":{"schemaVersion":{"type":"string","title":"Schemaversion"},"skillId":{"type":"string","title":"Skillid"},"priceUsd":{"type":"string","title":"Priceusd"},"status":{"type":"string","enum":["complete","partial","unavailable"],"title":"Status"},"query":{"additionalProperties":true,"type":"object","title":"Query"},"facts":{"additionalProperties":true,"type":"object","title":"Facts"},"interpretation":{"items":{"type":"string"},"type":"array","title":"Interpretation"},"coverage":{"items":{"$ref":"#/components/schemas/QueryCoverageItem"},"type":"array","title":"Coverage"},"toolsUsed":{"items":{"type":"string"},"type":"array","title":"Toolsused"},"asOf":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asof"},"generatedAt":{"type":"string","title":"Generatedat"},"lineageRefs":{"items":{"type":"string"},"type":"array","title":"Lineagerefs"},"payment":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payment"},"freshness":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Freshness"}},"type":"object","required":["schemaVersion","skillId","priceUsd","status","query","facts","interpretation","coverage","toolsUsed","asOf","generatedAt","lineageRefs"],"title":"QueryArtifactResponse","description":"Shared deterministic result envelope for bounded launch queries."},"QueryCoverageItem":{"properties":{"tool":{"type":"string","title":"Tool"},"status":{"type":"string","enum":["ok","unavailable"],"title":"Status"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"additionalProperties":true,"type":"object","required":["tool","status"],"title":"QueryCoverageItem"},"SecCompanyIdentityRequest":{"properties":{"query":{"type":"string","maxLength":120,"minLength":2,"title":"Query","description":"Ticker or legal company name, for example AAPL or Apple Inc.","examples":["AAPL"]}},"additionalProperties":false,"type":"object","required":["query"],"title":"SecCompanyIdentityRequest","description":"One bounded SEC company identity lookup."},"MachineRequestGuidance":{"type":"object","required":["type","title","status","code","detail","instance","recovery"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","enum":[405,422]},"code":{"type":"string","enum":["method_not_allowed","request_validation_failed"]},"detail":{"type":"string"},"instance":{"type":"string"},"issues":{"type":"array","items":{"type":"object","required":["location","message","errorType"],"properties":{"location":{"type":"array","items":{"type":"string"}},"message":{"type":"string"},"errorType":{"type":"string"}}}},"recovery":{"type":"object","required":["allowedMethods","schema","instructions","requestPayloadEchoed"],"properties":{"allowedMethods":{"type":"array","items":{"type":"string"}},"correctMethod":{"type":["string","null"]},"schema":{"type":"string","format":"uri"},"instructions":{"type":"string","format":"uri"},"requestPayloadEchoed":{"type":"boolean","const":false},"queryId":{"type":"string"},"documentation":{"type":"string","format":"uri"},"bodyExample":{"type":"object"}}}}}},"securitySchemes":{"qjAgentOAuth":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://agents.quantjourney.cloud/oauth/token","scopes":{"product:agents":"Access the QuantJourney Agents product.","agents:discover":"Read public and caller-specific agent discovery metadata.","agents:billing":"Read the client wallet and create bounded top-up sessions.","agents:query":"Submit bounded agent queries when execution is enabled."}}}}}},"externalDocs":{"description":"Full agent and OAuth integration guide","url":"https://agents.quantjourney.cloud/llms-full.txt"},"x-qj-control-plane-openapi":"https://agents.quantjourney.cloud/openapi-full.json"}