{ "openapi": "3.1.0", "info": { "title": "Signal Nodus", "version": "0.3.0", "description": "What changed in a filing, priced per call. compare_filings returns a sentence-level year-over-year diff of any 10-K/10-Q item, pinned to accession numbers; the other routes are cheap on-ramps to it. Every route answers HTTP 402 with an x402 challenge when no payment is presented; there is no signup step to fail at, because settling the challenge issues the credential. An MCP server over streamable HTTP is at https://mcp.signalnodus.ai/ .", "contact": { "email": "hgenix@agentmail.to" }, "license": { "name": "Data from US SEC EDGAR, a public primary source" }, "x-guidance": "Every route is a single GET with query parameters and returns JSON. Start with GET /v1/company to resolve a ticker to a CIK; it is free and proves the service works before any payment. The flagship is GET /v1/compare, a sentence-level year-over-year diff of one 10-K or 10-Q item, pinned to accession numbers so an amendment cannot move the baseline. Pay per call either by settling the x402 challenge on the 402 response, or by sending a prepaid key as Authorization: Bearer ; a key can be bought without a human at GET /v1/credit. There is no signup and no subscription. A 400 means the request itself is wrong and will never succeed unchanged; a 5xx means the service failed rather than the request." }, "servers": [ { "url": "https://api.signalnodus.ai" } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "Prepaid credit key: `Authorization: Bearer `. Buy one with no human at GET /v1/credit." }, "x402Payment": { "type": "apiKey", "in": "header", "name": "X-PAYMENT", "description": "Settle the x402 challenge from the 402 response and repeat the request with the signed payment." } } }, "paths": { "/v1/company": { "get": { "summary": "Resolve a ticker or name to a CIK and metadata.", "description": "Resolve a ticker or name to a CIK and metadata. Costs free per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Ticker or company name." } ], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v1/filings": { "get": { "summary": "List recent filings with accession numbers.", "description": "List recent filings with accession numbers. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Ticker or company name." }, { "name": "form", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Form type, for example 10-K." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Maximum filings to return." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 recent_filings call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/financials": { "get": { "summary": "As-reported XBRL facts for one concept.", "description": "As-reported XBRL facts for one concept. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Ticker or company name." }, { "name": "concept", "in": "query", "required": true, "schema": { "type": "string" }, "description": "XBRL concept, for example Assets." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 company_financials call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/section": { "get": { "summary": "One item from a filing as clean text.", "description": "One item from a filing as clean text. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Ticker or company name." }, { "name": "item", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Item identifier, for example 1A." }, { "name": "form", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Form type, for example 10-K." }, { "name": "accession", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Pin an exact filing so an amendment cannot move the baseline." }, { "name": "max_chars", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Truncate the returned text." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 filing_section call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/compare": { "get": { "summary": "Sentence-level diff of one item across two filings.", "description": "Sentence-level diff of one item across two filings. Costs $0.50 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Ticker or company name." }, { "name": "item", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Item identifier, for example 1A." }, { "name": "form", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Form type, for example 10-K." }, { "name": "from_accession", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Older filing to compare from." }, { "name": "to_accession", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Newer filing to compare to." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "500000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 compare_filings call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.500000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/whoholds": { "get": { "summary": "Which 13F managers hold a company, with total count.", "description": "Which 13F managers hold a company, with total count. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Ticker or company name." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Managers to return, max 100." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 who_holds call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/holdings": { "get": { "summary": "An institutional manager's latest 13F parsed: top positions by value.", "description": "An institutional manager's latest 13F parsed: top positions by value. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Manager name or CIK." }, { "name": "top", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Positions to return, max 100." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 institutional_holdings call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/insider": { "get": { "summary": "A company's latest Form 4 filings parsed into insider transactions.", "description": "A company's latest Form 4 filings parsed into insider transactions. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Ticker or company name." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Form 4 filings to parse, max 10." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 insider_trades call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/latest": { "get": { "summary": "Market-wide feed of filings as they land at EDGAR.", "description": "Market-wide feed of filings as they land at EDGAR. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "form", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filter to one form type, e.g. 8-K." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Entries to return, max 40." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 latest_filings call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/evm/balance": { "get": { "summary": "Native balance of any address, Base or Ethereum.", "description": "Native balance of any address, Base or Ethereum. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" }, "description": "base or ethereum. Default base." }, { "name": "address", "in": "query", "required": true, "schema": { "type": "string" }, "description": "0x address." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 evm_balance call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/evm/gas": { "get": { "summary": "Current gas price, Base or Ethereum.", "description": "Current gas price, Base or Ethereum. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" }, "description": "base or ethereum. Default base." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 evm_gas call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/evm/receipt": { "get": { "summary": "Transaction receipt: status, gas used, logs.", "description": "Transaction receipt: status, gas used, logs. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" }, "description": "base or ethereum. Default base." }, { "name": "tx", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Transaction hash." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 evm_receipt call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/token/price": { "get": { "summary": "Token price, FDV, market cap, 24h volume from aggregated DEX data.", "description": "Token price, FDV, market cap, 24h volume from aggregated DEX data. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" }, "description": "base or ethereum. Default base." }, { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Token contract address." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 token_price call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/fx/rate": { "get": { "summary": "ECB reference FX rates, one base to up to ten symbols.", "description": "ECB reference FX rates, one base to up to ten symbols. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "from", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Base currency, ISO 4217. Default USD." }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Comma list of target currencies. Default EUR." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 fx_rate call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/domain/report": { "get": { "summary": "One-call domain report: DNS records, SPF, registration age, registrar, expiry.", "description": "One-call domain report: DNS records, SPF, registration age, registrar, expiry. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Bare hostname, e.g. example.com." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 domain_report call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/markets/prediction": { "get": { "summary": "Top-volume Polymarket markets with implied probabilities, optionally filtered.", "description": "Top-volume Polymarket markets with implied probabilities, optionally filtered. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Substring filter over market questions." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Markets to return, max 25." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 prediction_markets call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/search": { "get": { "summary": "Exact-phrase full-text search over all EDGAR filings since 2001.", "description": "Exact-phrase full-text search over all EDGAR filings since 2001. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Exact phrase, 2-200 characters." }, { "name": "forms", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Comma list of form types, e.g. 10-K,8-K." }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Start date, YYYY-MM-DD." }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string" }, "description": "End date, YYYY-MM-DD." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Hits to return, max 50." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 edgar_search call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/events": { "get": { "summary": "A company's 8-K material events with decoded item codes.", "description": "A company's 8-K material events with decoded item codes. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Ticker or company name." }, { "name": "item", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Item-code filter, e.g. 5.02." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Events to return, max 25." }, { "name": "include_amendments", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Also include 8-K/A amendments." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 filing_events call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/activists": { "get": { "summary": "Schedule 13D/13G filings naming a company: activist and passive stakes.", "description": "Schedule 13D/13G filings naming a company: activist and passive stakes. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Ticker or company name." }, { "name": "days", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Lookback window in days, 30-730." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filings to return, max 100." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 activist_stakes call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/ipos": { "get": { "summary": "New S-1/F-1 registrations market-wide: the earliest IPO signal.", "description": "New S-1/F-1 registrations market-wide: the earliest IPO signal. Costs $0.01 per call. No account and no subscription.", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filings to return, max 40." }, { "name": "include_amendments", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Also include S-1/A and F-1/A." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "10000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 ipo_pipeline call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/gov/contracts": { "get": { "summary": "US federal prime contract awards to a company, from USAspending.gov.", "description": "US federal prime contract awards to a company, from USAspending.gov. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Recipient name, e.g. Lockheed Martin." }, { "name": "days", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Lookback window in days, 30-1825." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Awards to return, max 25." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 government_contracts call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/energy": { "get": { "summary": "US energy prices and grid demand from EIA.", "description": "US energy prices and grid demand from EIA. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "series", "in": "query", "required": true, "schema": { "type": "string" }, "description": "electricity_price, fuel_price or grid_demand." }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Two-letter state code, for electricity_price." }, { "name": "sector", "in": "query", "required": false, "schema": { "type": "string" }, "description": "RES, COM, IND, TRA or ALL, for electricity_price." }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Balancing-authority code, for grid_demand." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Rows to return, max 100." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 energy_data call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/crops": { "get": { "summary": "USDA NASS crop and livestock estimates.", "description": "USDA NASS crop and livestock estimates. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "commodity", "in": "query", "required": true, "schema": { "type": "string" }, "description": "NASS commodity name, e.g. CORN." }, { "name": "statistic", "in": "query", "required": false, "schema": { "type": "string" }, "description": "YIELD, PRODUCTION, AREA HARVESTED, AREA PLANTED, STOCKS or PRICE RECEIVED." }, { "name": "year", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Four-digit year." }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Two-letter state code. Omit for national." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Rows to return, max 100." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 crop_data call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/trade": { "get": { "summary": "US monthly imports or exports by HS chapter and partner.", "description": "US monthly imports or exports by HS chapter and partner. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "hs_code", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Two-digit HS chapter, e.g. 87." }, { "name": "year", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Four-digit year." }, { "name": "month", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Month, 01 through 12." }, { "name": "direction", "in": "query", "required": false, "schema": { "type": "string" }, "description": "exports or imports. Default exports." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 trade_flows call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/cftc/positioning": { "get": { "summary": "CFTC Commitments of Traders positioning for a futures contract.", "description": "CFTC Commitments of Traders positioning for a futures contract. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "market", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Contract name fragment, e.g. CRUDE OIL, WHEAT, GOLD." }, { "name": "weeks", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Weeks of history per contract, max 26." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 cftc_positioning call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/gov/lobbying": { "get": { "summary": "US Senate LDA lobbying disclosures for a client company.", "description": "US Senate LDA lobbying disclosures for a client company. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Client company name." }, { "name": "year", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filing year filter." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filings to return, max 25." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 lobbying call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/score/churn": { "get": { "summary": "Year-over-year churn of a filing item as one scored verdict.", "description": "Year-over-year churn of a filing item as one scored verdict. Costs $0.10 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Ticker or company name." }, { "name": "item", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Item identifier. Default 1A." }, { "name": "form", "in": "query", "required": false, "schema": { "type": "string" }, "description": "10-K or 10-Q. Default 10-K." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "100000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 risk_churn_score call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/x402/audit": { "get": { "summary": "Inspect a public x402 endpoint and report its 402 challenge; no payment signed.", "description": "Inspect a public x402 endpoint and report its 402 challenge; no payment signed. Costs $0.10 per call. No account and no subscription.", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Absolute https URL of the x402 resource." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "100000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 x402_audit call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/token/report": { "get": { "summary": "One-call token due-diligence data: price, liquidity, volume, flags.", "description": "One-call token due-diligence data: price, liquidity, volume, flags. Costs $0.10 per call. No account and no subscription.", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" }, "description": "base, ethereum, or arbitrum. Default base." }, { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Token contract address." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "100000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 token_report call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/gas/optimizer": { "get": { "summary": "Cheapest-chain gas as USD cost of a standard transfer.", "description": "Cheapest-chain gas as USD cost of a standard transfer. Costs $0.05 per call. No account and no subscription.", "parameters": [ { "name": "chains", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Comma list from base, arbitrum, ethereum." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "50000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 gas_optimizer call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/verify/claim": { "get": { "summary": "Deterministic check of a numeric claim against as-filed XBRL.", "description": "Deterministic check of a numeric claim against as-filed XBRL. Costs $0.10 per call. No account and no subscription.", "parameters": [ { "name": "company", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Ticker or company name." }, { "name": "concept", "in": "query", "required": true, "schema": { "type": "string" }, "description": "XBRL concept, e.g. Revenues." }, { "name": "claimed_value", "in": "query", "required": true, "schema": { "type": "string" }, "description": "The asserted value." }, { "name": "fiscal_year", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Fiscal year of the claim." }, { "name": "fiscal_period", "in": "query", "required": false, "schema": { "type": "string" }, "description": "FY, Q1-Q4. Default FY." }, { "name": "end", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Exact period end date, alternative to fiscal_year." }, { "name": "tolerance_pct", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Match tolerance percent. Default 0.5." } ], "security": [ { "bearerAuth": [] }, { "x402Payment": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } }, "x-payment-info": { "amount": "100000", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "1 verify_financial_claim call", "intent": "charge", "method": "evm", "network": "8453", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30", "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } }, { "mpp": { "method": "evm", "intent": "charge", "network": "8453", "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "recipient": "0xcf7682647d17803f997308a10c191557d899ec30" } } ] } } }, "/v1/credit": { "get": { "summary": "Buy a reusable API key with a machine payment.", "description": "Answers 402. Settle the challenge and the response body contains a working API key. This is the whole registration flow: there is no email, no confirmation link, no CAPTCHA, and no human.", "parameters": [ { "name": "pack", "in": "query", "required": false, "schema": { "type": "string" }, "description": "starter, builder, or scale." } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "402": { "description": "Payment required. Carries WWW-Authenticate: Payment and an x402 PAYMENT-REQUIRED header. Settle it and repeat the request.", "content": { "application/problem+json": { "schema": { "type": "object" } } } } } } } } }