Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Maxwell International Data (x402) Edgar API
version: 1.0.0
description: Machine-only pay-per-call data API over x402. Prices are per request in USDC.
x-guidance: 'Pay-per-call data for ski trips and public records, plus x402 Doctor, which tests other x402 endpoints for you. Ski: a directory of about 6,000 ski resorts worldwide, lift-ticket prices for the resorts listed at /v1/ski/coverage, a model forecast for every resort (station readings where one of 11 European met services has a station), lift status and snow reports only at about 50 resorts with their own feed (in Poland, Slovakia, Switzerland, Liechtenstein and Friuli in Italy; only while current), insider tips, and the Trip Wizard (a free map, then one paid call per trip step). Food: restaurants around ski resorts in every country listed at /v1/food/coverage (free, with per-country counts), with opening hours, website and contacts where known. Menus and prices only where read (withMenu): in Andorra, Austria, Bulgaria, Czechia, Finland, France, Germany, Italy, Liechtenstein, Norway, Poland, Slovakia, Slovenia, Spain, Sweden and Switzerland from the restaurant’s own website or, where none is published, a delivery app; in every other country only where a delivery app (Wolt, Bolt Food, Glovo, Pyszne.pl) lists the restaurant, as restaurants’ own websites are read for menus only in those 16 countries. Public data: SEC EDGAR, government registers and legislation of 13 countries and the EU, OFAC SDN, NVD CVEs, openFDA, NOAA weather (US), ECB FX, FRED, npm, RDAP domain records, crypto market quotes, US court opinions, US patents. Paid operations are GET, except doctor.payment and llm.chat (POST with a JSON body). Call one without payment to receive HTTP 402 with a PAYMENT-REQUIRED header (x402 v2): USDC on Base (eip155:8453) or Solana, settled through the Coinbase CDP facilitator. Send the same request again with a PAYMENT-SIGNATURE header. You are charged only for a 2xx answer. Missing or ambiguous parameters get a free 400 or 409 and a request with no data on file a free 404, both with charged:false. A search that runs and finds nothing is a 2xx answer (match:false) and is charged. Most routes check parameters before asking for payment. A bare path (directory probes), ski.prices without country, gov.de legislation and open data, and a POST without the fields it needs get the 402 first; after payment a request that cannot be answered still gets a free 400 (ski.prices answers if the resort id is unique). food.menu without restaurantId is a free 404. Paid answers that can look empty: a search with no matches (match:false), an RDAP lookup of an unregistered domain (registered:false) or of a registry without RDAP (rdapAvailable:false), and gov.de legislation or open data without q or id (the index of what is cached). doctor.buy and llm.chat collect the payment before they run: doctor.buy charges for the attempt, delivered or not; if the llm.chat model fails after payment, the answer (HTTP 503, llm_failed_after_payment) says charged:true and the payment is refunded by hand. A lookup of one item that is not cached yet (CVE, accession, company number, coordinates) is usually queued: retry after retryAfterSec. Priced per request (x-payment-info mode dynamic, with min and max where there is one): doctor.buy, llm.chat, trip.bundle; the 402 quotes the exact amount. Every other product has one price. Each response carries fetchedAt or generatedAt. Forecasts refresh every 6 hours, and lift status every 15 minutes where the resort has a feed. Hand-checked lift-ticket prices were read from official price lists on Oct 7-9, 2026 (rechecks from Nov 8); the others come from a weekly crawl of the resort''s price pages or from an earlier collection (operator shops, price pages); every row has its source link and read date. Public records refresh on each source''s schedule (age per family at /health). Free status and coverage endpoints are listed at /catalog.json; terms at /terms.json. Free samples: most products have one real request you can call free to check the data first (freeSampleUrl in /catalog.json, x-free-sample here, freeSample in every 402): the same answer a buyer of that request gets.'
contact:
name: Maxwell International
email: accounts@maxwellinternational.ai
url: https://api.maxwellinternational.ai/terms.json
termsOfService: https://api.maxwellinternational.ai/terms.json
servers:
- url: https://api.maxwellinternational.ai
tags:
- name: edgar
paths:
/v1/edgar/company:
get:
operationId: edgar_company
summary: 'SEC EDGAR company profile for a ticker or CIK: SIC, fiscal year end, addresses…'
description: 'SEC EDGAR company profile for a ticker or CIK: SIC, fiscal year end, addresses, and recent filings.'
tags:
- edgar
parameters:
- name: ticker
in: query
required: false
schema:
type: string
example: AAPL
- name: cik
in: query
required: false
schema:
type: string
example: '320193'
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.005'
protocols:
- x402: {}
x-free-sample:
url: https://api.maxwellinternational.ai/v1/edgar/company?ticker=AAPL&sample=1
note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
responses:
'200':
description: Paid response (charged)
content:
application/json:
schema:
type: object
properties:
cik:
type: string
name:
type: string
tickers:
type: array
items:
type: string
exchanges:
type: array
items:
type: string
sic:
type: string
sicDescription:
type: string
fiscalYearEnd:
type: string
stateOfIncorporation:
type: string
phone:
type: string
website: {}
investorWebsite: {}
category:
type: string
addresses:
type: object
properties:
mailing:
type: object
properties:
street1:
type: string
street2: {}
city:
type: string
stateOrCountry:
type: string
zipCode:
type: string
stateOrCountryDescription:
type: string
isForeignLocation:
type: integer
foreignStateTerritory: {}
country: {}
countryCode: {}
business:
type: object
properties:
street1:
type: string
street2: {}
city:
type: string
stateOrCountry:
type: string
zipCode:
type: string
stateOrCountryDescription:
type: string
isForeignLocation: {}
foreignStateTerritory: {}
country: {}
countryCode: {}
filingCountsByForm:
type: object
properties:
'3':
type: integer
'4':
type: integer
'144':
type: integer
8-K/A:
type: integer
10-Q:
type: integer
8-K:
type: integer
SD:
type: integer
SCHEDULE 13G:
type: integer
SCHEDULE 13G/A:
type: integer
PX14A6G:
type: integer
DEFA14A:
type: integer
DEF 14A:
type: integer
25-NSE:
type: integer
10-K:
type: integer
144/A:
type: integer
S-8:
type: integer
filings:
type: array
items:
type: object
properties:
accession:
type: string
form:
type: string
filed:
type: string
reportDate:
type: string
primaryDocument:
type: string
description:
type: string
size:
type: integer
indexUrl:
type: string
filingUrl:
type: string
documentsUrl:
type: string
secViewerUrl:
type: string
financialHighlights:
type: array
items:
type: object
properties:
tag:
type: string
taxonomy:
type: string
label:
type: string
unit:
type: string
value:
type: integer
period:
type: object
properties: {}
end:
type: string
filed:
type: string
form:
type: string
fy:
type: integer
fp:
type: string
factsError: {}
fetchedAt:
type: string
sources:
type: object
properties:
submissions:
type: string
companyfacts:
type: string
keyFilings:
type: array
items:
type: object
properties:
accession:
type: string
form:
type: string
filed:
type: string
reportDate:
type: string
primaryDocument:
type: string
description:
type: string
size:
type: integer
indexUrl:
type: string
filingUrl:
type: string
documentsUrl:
type: string
secViewerUrl:
type: string
example:
cik: 0000320193
name: Apple Inc.
tickers:
- AAPL
exchanges:
- Nasdaq
sic: '3571'
sicDescription: Electronic Computers
fiscalYearEnd: 0926
stateOfIncorporation: CA
phone: (408) 996-1010
website: null
investorWebsite: null
category: Large accelerated filer
'400':
description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
'402':
description: Payment Required
'404':
description: No data on file for this request (not cached or not found); not charged (charged:false)
/v1/edgar/filing:
get:
operationId: edgar_filing
summary: 'One SEC EDGAR filing by accession number: form, filing and acceptance dates…'
description: 'One SEC EDGAR filing by accession number: form, filing and acceptance dates, report period, 8-K items with descriptions, file number, XBRL flags, primary document and SEC URLs. Accessions submitted by filing agents also need ticker or cik. Covers each cached company''s latest 1000 filings; a miss is 404 and not charged.'
tags:
- edgar
parameters:
- name: accession
in: query
required: true
schema:
type: string
example: 0000320193-26-000020
- name: ticker
in: query
required: false
schema:
type: string
example: AAPL
- name: cik
in: query
required: false
schema:
type: string
example: '320193'
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.005'
protocols:
- x402: {}
x-free-sample:
url: https://api.maxwellinternational.ai/v1/edgar/filing?accession=0000320193-26-000020&sample=1
note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
responses:
'200':
description: Paid response (charged)
content:
application/json:
schema:
type: object
properties:
accession:
type: string
cik:
type: string
company:
type: object
properties:
name:
type: string
tickers:
type: array
items:
type: string
exchanges:
type: array
items:
type: string
sic:
type: string
sicDescription:
type: string
form:
type: string
filingDate:
type: string
reportDate:
type: string
acceptanceDateTime:
type: string
act:
type: string
fileNumber:
type: string
filmNumber:
type: string
items:
type: array
size:
type: integer
isXBRL:
type: boolean
isInlineXBRL:
type: boolean
primaryDocument:
type: string
primaryDocDescription:
type: string
urls:
type: object
properties:
indexUrl:
type: string
filingUrl:
type: string
documentsUrl:
type: string
secViewerUrl:
type: string
related:
type: object
properties:
company:
type: string
financials:
type: string
source:
type: string
fetchedAt:
type: string
notice:
type: string
example:
accession: 0000320193-26-000020
cik: 0000320193
company:
name: Apple Inc.
tickers: []
exchanges: []
sic: '3571'
sicDescription: Electronic Computers
form: 10-Q
filingDate: '2026-07-31'
reportDate: '2026-06-27'
acceptanceDateTime: '2026-07-31T10:01:02.000Z'
act: '34'
fileNumber: 001-36743
filmNumber: '261225227'
items: []
size: 5946811
'400':
description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
'402':
description: Payment Required
'404':
description: No data on file for this request (not cached or not found); not charged (charged:false)
/v1/edgar/financials:
get:
operationId: edgar_financials
summary: 'Compact financial statements from SEC XBRL company facts: about 40 standard…'
description: 'Compact financial statements from SEC XBRL company facts: about 40 standard us-gaap and dei line items (revenue, net income, EPS, cash, debt, shares...), one value per calendar period, last 10 years and 12 quarters, fiscal Q4 derived. A tag a company stopped using ends in that year.'
tags:
- edgar
parameters:
- name: ticker
in: query
required: false
schema:
type: string
example: AAPL
- name: cik
in: query
required: false
schema:
type: string
example: '320193'
- name: tags
in: query
required: false
schema:
type: string
example: RevenueFromContractWithCustomerExcludingAssessedTax,NetIncomeLoss
- name: period
in: query
required: false
schema:
type: string
enum:
- annual
- quarterly
example: quarterly
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.005'
protocols:
- x402: {}
x-free-sample:
url: https://api.maxwellinternational.ai/v1/edgar/financials?ticker=AAPL&sample=1
note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
responses:
'200':
description: Paid response (charged)
content:
application/json:
schema:
type: object
properties:
cik:
type: string
entityName:
type: string
fetchedAt:
type: string
source:
type: string
tagCount:
type: integer
periods:
type: object
properties:
annual:
type: integer
quarterly:
type: integer
dedupe:
type: string
latestPeriodEnd:
type: object
properties:
Revenues:
type: string
RevenueFromContractWithCustomerExcludingAssessedTax:
type: string
SalesRevenueNet:
type: string
CostOfGoodsAndServicesSold:
type: string
GrossProfit:
type: string
ResearchAndDevelopmentExpense:
type: string
SellingGeneralAndAdministrativeExpense:
type: string
OperatingExpenses:
type: string
OperatingIncomeLoss:
type: string
InterestExpense:
type: string
IncomeLossFromContinuingOperationsBeforeIncomeTaxesExtraordinaryItemsNoncontrollingInterest:
type: string
IncomeTaxExpenseBenefit:
type: string
NetIncomeLoss:
type: string
EarningsPerShareBasic:
type: string
EarningsPerShareDiluted:
type: string
WeightedAverageNumberOfDilutedSharesOutstanding:
type: string
Assets:
type: string
AssetsCurrent:
type: string
Liabilities:
type: string
LiabilitiesCurrent:
type: string
LiabilitiesAndStockholdersEquity:
type: string
StockholdersEquity:
type: string
CashAndCashEquivalentsAtCarryingValue:
type: string
MarketableSecuritiesCurrent:
type: string
AccountsReceivableNetCurrent:
type: string
InventoryNet:
type: string
PropertyPlantAndEquipmentNet:
type: string
Goodwill:
type: string
LongTermDebt:
type: string
LongTermDebtNoncurrent:
type: string
NetCashProvidedByUsedInOperatingActivities:
type: string
NetCashProvidedByUsedInInvestingActivities:
type: string
NetCashProvidedByUsedInFinancingActivities:
type: string
PaymentsToAcquirePropertyPlantAndEquipment:
type: string
DepreciationDepletionAndAmortization:
type: string
ShareBasedCompensation:
type: string
PaymentsOfDividends:
type: string
PaymentsForRepurchaseOfCommonStock:
type: string
CommonStockSharesOutstanding:
type: string
EntityCommonStockSharesOutstanding:
type: string
EntityPublicFloat:
type: string
facts:
type: object
properties:
RevenueFromContractWithCustomerExcludingAssessedTax:
type: object
properties:
taxonomy:
type: string
label:
type: string
unit:
type: string
annual:
type: array
items:
type: object
quarterly:
type: array
items:
type: object
NetIncomeLoss:
type: object
properties:
taxonomy:
type: string
label:
type: string
unit:
type: string
annual:
type: array
items:
type: object
quarterly:
type: array
items:
type: object
availableTags:
type: array
items:
type: string
example:
cik: 0000320193
entityName: Apple Inc.
fetchedAt: '2026-10-05T08:23:59.216Z'
source: https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json
tagCount: 41
periods:
annual: 10
quarterly: 12
dedupe: SEC calendar frame
latestPeriodEnd:
Revenues: '2018-09-29'
RevenueFromContractWithCustomerExcludingAssessedTax: '2026-06-27'
SalesRevenueNet: '2018-06-30'
CostOfGoodsAndServicesSold: '2026-06-27'
GrossProfit: '2026-06-27'
ResearchAndDevelopmentExpense: '2026-06-27'
SellingGeneralAndAdministrativeExpense: '2026-06-27'
OperatingExpenses: '2026-06-27'
OperatingIncomeLoss: '2026-06-27'
InterestExpense: '2023-09-30'
IncomeLossFromContinuingOperationsBeforeIncomeTaxesExtraordinaryItemsNoncontrollingInterest: '2026-06-27'
IncomeTaxExpenseBenefit: '2026-06-27'
facts:
RevenueFromContractWithCustomerExcludingAssessedTax:
taxonomy: us-gaap
label: Revenue from Contract with Customer, Excluding Assessed Tax
unit: USD
annual: []
quarterly: []
NetIncomeLoss:
taxonomy: us-gaap
label: Net Income (Loss) Attributable to Parent
unit: USD
annual: []
quarterly: []
availableTags:
- Revenues
'400':
description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
'402':
description: Payment Required
'404':
description: No data on file for this request (not cached or not found); not charged (charged:false)
/v1/edgar/search:
get:
operationId: edgar_search
summary: Look up SEC EDGAR companies by ticker or name; returns CIK, ticker, and company…
description: Look up SEC EDGAR companies by ticker or name; returns CIK, ticker, and company name.
tags:
- edgar
parameters:
- name: q
in: query
required: true
schema:
type: string
example: tesla
- name: limit
in: query
required: false
schema:
type: integer
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.005'
protocols:
- x402: {}
x-free-sample:
url: https://api.maxwellinternational.ai/v1/edgar/search?q=tesla&sample=1
note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
responses:
'200':
description: Paid response (charged)
content:
application/json:
schema:
type: object
properties:
query:
type: string
source:
type: string
fetchedAt:
type: string
count:
type: integer
hits:
type: array
items:
type: object
properties:
cik:
type: string
ticker:
type: string
name:
type: string
match:
type: boolean
example:
query: TESLA
source: sec.gov company_tickers (cached)
fetchedAt: '2026-10-05T08:20:22.235Z'
count: 1
hits:
- cik: 0001318605
ticker: TSLA
name: Tesla, Inc.
match: true
'400':
description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
'402':
description: Payment Required
'404':
description: No data on file for this request (not cached or not found); not charged (charged:false)