Docs / API para agentes

API para agentes

Rotas de dados com pagamento por chamada para agentes de IA. Pague cada requisição em USDC na Base com x402. Sem conta, sem chave de API.

URL base: https://johto-x402-api.johtodata.workers.dev

Preço	Rota, campos e exemplo
$0.002 por chamada	`GET /v1/jp-invoice-check` Japan qualified-invoice check Returns: Status of one Japanese qualified-invoice issuer registration number (T + 13 digits) for corporations: registration number, status (registered, cancelled, expired, not_found), name, registration, update, cancel and expire dates when set, head-office prefecture and data date. Batch: POST up to 1,000 numbers at $0.0012 per unique number. Use when: you need to confirm that a Japanese supplier's invoice registration number is valid before you pay or onboard them. Don't use when: you need sole-proprietor registrations (they return not_found), company financials or people data. Free sample (no payment): curl -s "https://johto-x402-api.johtodata.workers.dev/v1/jp-invoice-check?sample=1"
$0.003 por chamada	`GET /v1/sec-13f` SEC 13F holdings Returns: 13F-HR holdings for one institutional filer (fund or manager), top positions by value, up to 100 per call: filerName, filerCik, reportDate, filedAt, accessionNumber, and per holding issuer, cusip, titleOfClass, valueUsd, shares, sharesType, putCall, investmentDiscretion, votingSole, votingShared, votingNone and pctOfPortfolio, plus portfolio total and fetchedAt. Newest report period by default; pick any 13F-HR or 13F-HR/A with accession. Pass exactly one of cik or ticker. Free sample: Use when: you need what a fund or investment manager reported holding at quarter end: positions by CUSIP with value, shares, put/call and voting authority, ranked by value. Don't use when: you need intra-quarter trades, insider Form 4 trades, short positions, holdings not reported on 13F (non-US listings, most bonds, cash), or ticker symbols for each position (13F reports CUSIPs). Free sample (no payment): curl "https://johto-x402-api.johtodata.workers.dev/v1/sec-13f?sample=1" First paid call (answers 402 with the price and payment details): curl -i "https://johto-x402-api.johtodata.workers.dev/v1/sec-13f?cik=1067983&limit=25" Example response (free sample, 1 row): {"filerCik":"0001067983","filerName":"BERKSHIRE HATHAWAY INC","formType":"13F-HR","isAmendment":false,"reportDate":"2026-06-30","reportQuarter":"2026Q2","filedDate":"2026-08-14","filedAt":"2026-08-15T00:05:04.000Z","accessionNumber":"0001193125-26-352200","accessionUrl":"https://www.sec.gov/Archives/edgar/data/1067983/000119312526352200/0001193125-26-352200-index.htm","infoTableUrl":"https://www.sec.gov/Archives/edgar/data/1067983/000119312526352200/56757.xml","otherAmendmentsForPeriod":[],"portfolioValueUsd":299253556246,"positionsCount":29,"rank":1,"issuer":"APPLE INC","titleOfClass":"COM","cusip":"037833100","valueUsd":65950296923,"shares":227917808,"sharesType":"SH","putCall":null,"inves ...
$0.003 por chamada	`GET /v1/sec-8k` SEC 8-K filings Returns: Recent 8-K and 8-K/A filings for one SEC filer, up to 20 per call, newest first: companyName, cik, ticker, formType, filedDate, filedAt, reportDate, accessionNumber, items with item names, fileNumber, documentUrl and filingIndexUrl, plus fetchedAt. Pass exactly one of ticker or cik. Free sample: Use when: you need a company's recent 8-K current reports (earnings, executive changes, deals, other material events) with item codes and links to each filing. Don't use when: you need the full filing text, other forms (10-K, 10-Q, Form 4, 13F), a feed across all companies, or filers outside SEC EDGAR. Free sample (no payment): curl "https://johto-x402-api.johtodata.workers.dev/v1/sec-8k?sample=1" First paid call (answers 402 with the price and payment details): curl -i "https://johto-x402-api.johtodata.workers.dev/v1/sec-8k?ticker=AAPL&limit=10" Example response (free sample, 1 row): {"accessionNumber":"0000320193-26-000018","cik":"0000320193","companyName":"Apple Inc.","ticker":"AAPL","formType":"8-K","isAmendment":false,"filedDate":"2026-07-30","filedAt":"2026-07-31T00:30:28.000Z","reportDate":"2026-07-30","items":["2.02","9.01"],"itemNames":["Results of Operations and Financial Condition","Financial Statements and Exhibits"],"fileNumber":"001-36743","documentUrl":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260730.htm","filingIndexUrl":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/0000320193-26-000018-index.htm"}
$0.0025 por chamada	`GET /v1/sanctions-screen` Sanctions screen Returns: Screen one person or entity name against the OFAC SDN list and the UK Sanctions List: verdict (MATCH, POSSIBLE_MATCH, CLEAR) and up to 20 matches with list, programs, score and match type. Fuzzy matching handles typos, word order and company suffixes. A screening aid, not legal advice. Use when: you want a quick screening signal for one name before a payment, deal or onboarding step. Don't use when: you need a legal determination, adverse media, or screening of wallet addresses (use /v1/wallet-risk). Free sample (no payment): curl -s "https://johto-x402-api.johtodata.workers.dev/v1/sanctions-screen?sample=1"
$0.003 por chamada	`GET /v1/uk-tenders` UK tender notices Returns: Up to 25 newest UK tender notices from Find a Tender (feed=fts, default) or Contracts Finder (feed=cf), read live for each call: title, buyer organisation, published and deadline dates, value and currency when stated, CPV codes, procedure, notice URL and next_cursor. No charge when nothing matches. Use when: you need fresh UK tender notices to find bid opportunities or track buyers, with CPV codes and deadlines. Don't use when: you need contact people, award winners, full tender documents, or notices from outside the UK. Free sample (no payment): curl -s "https://johto-x402-api.johtodata.workers.dev/v1/uk-tenders?sample=1"
$0.006 por chamada	`GET /v1/fr-tenders` French tender notices Returns: Up to 25 newest French tender notices from BOAMP, read live for each call, filterable by département and keyword: title, buyer organisation, published and deadline dates, descriptors, procedure, notice type and notice URL (value not included). No charge when nothing matches. Use when: you need fresh French tender notices (marchés publics) by département or keyword to find bid opportunities. Don't use when: you need contract values, contact people, award winners, full tender documents, or notices from outside France. Free sample (no payment): curl -s "https://johto-x402-api.johtodata.workers.dev/v1/fr-tenders?sample=1"
$0.0035 por chamada	`GET /v1/au-contracts` Australian contract awards Returns: Up to 25 Australian federal contract notices (awarded contracts) from AusTender, read live for each call, by publish date range: title, buying agency, published date, contract value in AUD, UNSPSC code, procurement method, notice URL and next_cursor. Supplier names not included. No charge when nothing matches. Use when: you need recent Australian federal contract awards by agency, value and UNSPSC category for market sizing or account research. Don't use when: you need open tenders you can still bid on, supplier names, contact people, or state and local government contracts. Free sample (no payment): curl -s "https://johto-x402-api.johtodata.workers.dev/v1/au-contracts?sample=1"
$0.011 por chamada	`GET /v1/tenders` Tender bundle: EU, UK, France and Australia Returns: One fixed bundle of the newest notices from 4 markets, 10 rows each, read live for each call: EU (TED), UK (Find a Tender), France (BOAMP) and Australia (AusTender contract notices, awarded contracts). Every row carries market, source and licence: notice ID, title, buyer, published and deadline dates, value and currency when stated, categories, procedure and notice URL. A market whose feed fails is marked unavailable; you are charged only when at least one market returns rows. No parameters. Use when: you want one call that returns fresh tender and contract notices across the EU, UK, France and Australia. Don't use when: you need filters, more than 10 rows per market, contact people or full tender documents (use the single-market routes above). Licences: TED notices under the EU reuse notice (Commission Decision 2011/833/EU); UK under the Open Government Licence v3.0; France under the Licence Ouverte / Open Licence (DILA, BOAMP); Australia under CC BY 3.0 AU (Department of Finance, AusTender). Free sample (no payment): curl -s "https://johto-x402-api.johtodata.workers.dev/v1/tenders?sample=1" First paid call (answers 402 with the price and payment details): curl -i "https://johto-x402-api.johtodata.workers.dev/v1/tenders"
$0.0029 por chamada	`GET /v1/kyb` Company verification (KYB) Returns: Company verification from GLEIF LEI and SEC EDGAR: LEI status, registration number, jurisdiction, direct and ultimate parent, CIK, ticker, EIN, SIC and last filing. Up to 10 rows. Use when: you need to confirm a company's legal identity (LEI, registration number, jurisdiction, parents, SEC CIK and ticker) before onboarding or a deal. Don't use when: you need data on people, credit scores, financial statements or sanctions screening. First call (answers 402 with the price and payment details): curl -i "https://johto-x402-api.johtodata.workers.dev/v1/kyb?name=Tesla,%20Inc." Example request: `/v1/kyb?name=Tesla,%20Inc.` Example response (live, 1 row): {"data":[{"identifiers":{"bic":["TSLAUS66XXX"],"cik":null,"companyNumber":"0805587591","lei":"54930043XZGB27CTOV49","registrationAuthorityId":"RA000637","ticker":null},"incorporationDate":"2024-06-14","jurisdiction":"US-TX","lei":{"legalFormCode":"C5K7","parent":{"lei":null,"name":null,"reportingException":"NO_KNOWN_PERSON"},"registrationStatus":"ISSUED","ultimateParent":{"lei":null,"name":null,"reportingException":"NO_KNOWN_PERSON"}},"name":"TESLA, INC.","source":"gleif","sourceUrl":"https://search.gleif.org/#/record/54930043XZGB27CTOV49","status":"ACTIVE"}],"rows":1}
$0.0025 por chamada	`GET /v1/wallet-risk` Wallet risk screen Returns: Screen one EVM address against the OFAC SDN list and the ScamSniffer phishing address list. Returns verdict (BLOCK, REVIEW, CLEAR), riskScore, flags, ofacSanctioned, ofacMatches (OFAC id, currency, programs), scamSnifferListed and listsAsOf. Snapshots: OFAC SDN list 2026-10-21, ScamSniffer phishing address list 2026-10-22. A screening aid, not legal advice. Invalid input returns 400, not charged. Use when: you want a quick check of one EVM address against the OFAC SDN list and the ScamSniffer phishing address list before you send funds, accept a payment or onboard a wallet. Don't use when: you need Bitcoin, Tron or Solana addresses, name-based sanctions screening, transaction history, or a legal determination. Free sample (no payment): curl "https://johto-x402-api.johtodata.workers.dev/v1/wallet-risk?sample=1" First paid call (answers 402 with the price and payment details): curl -i "https://johto-x402-api.johtodata.workers.dev/v1/wallet-risk?address=0x28c6c06298d514db089934071355e5743bf21d60" Example response (free sample, 1 row): {"address":"0x28c6c06298d514db089934071355e5743bf21d60","addressType":"evm","verdict":"CLEAR","riskScore":0,"flags":[],"flagsText":"","summary":"CLEAR: 0x28c6c062\u2026 not on the OFAC SDN list, not on the ScamSniffer phishing address list (snapshots 2026-10-21 / 2026-10-22).","ofacSanctioned":false,"ofacMatches":[],"ofacListDate":"2026-10-21","ofacListMode":"snapshot","scamSnifferListed":false,"scamSnifferChecked":true,"listsAsOf":{"ofacSdn":{"name":"OFAC SDN list","asOf":"2026-10-21","fetchedAt":"2026-10-22T11:27:12Z","source":"https://www.treasury.gov/ofac/downloads/sdn.xml"},"scamSniffer":{"name":"ScamSniffer phishing address list","asOf":"2026-10-22","fetchedAt":"2026-10-22T11:27:23Z"," ...
$0.0019 por chamada	`GET /v1/read` Read one page as Markdown Returns: Read one web page as Markdown: URL, HTTP status, title, Markdown, token estimate and content hash. One http(s) URL per call. robots.txt is respected; not charged if the page fails or robots.txt blocks it. Use when: you need one web page as clean Markdown for an LLM or RAG pipeline. Don't use when: you need many pages from one site (use /v1/crawl), or the page needs a login or sits behind a paywall. First call (answers 402 with the price and payment details): curl -i "https://johto-x402-api.johtodata.workers.dev/v1/read?url=https://docs.apify.com/platform/actors" Example request: `/v1/read?url=https://docs.apify.com/platform/actors` Example response (live, 1 row): {"data":{"url":"https://docs.apify.com/platform/actors","title":"Actors","markdown":"# Actors ...","tokensEstimate":744,"contentHash":"15c0c036fb715d8f"},"rows":1}
$0.0045 por chamada	`GET /v1/crawl` Web crawl to Markdown Returns: Crawl up to 20 pages under a start URL into Markdown: URL, title, Markdown, token estimate and content hash per page. Use when: you need a docs site or one section of a site (up to 20 pages under a start URL) as Markdown. Don't use when: you need a single page (use /v1/read), more than 20 pages, pages outside the start URL path, or content behind a login or paywall. First call (answers 402 with the price and payment details): curl -i "https://johto-x402-api.johtodata.workers.dev/v1/crawl?pages=10&url=https://crawlee.dev/python/docs" Example request: `/v1/crawl?pages=10&url=https://crawlee.dev/python/docs` Example response (live, 1 row): {"data":[{"contentHash":"fc2f086388e350bc","markdown":"* [](https://crawlee.dev/python/python)\n* [Examples](https://crawlee.dev/python/ ...","title":"BeautifulSoup crawler","tokensEstimate":1504,"url":"https://crawlee.dev/python/docs/examples/beautifulsoup-crawler.md"}],"rows":1}
$0.01 por chamada	`GET /v1/jobs` Lever jobs Returns: Open jobs from named Lever boards, up to 25 per call: title, location, remote flag, published salary range, employment type, posted date and apply URL. Use when: you need current open roles at named companies that hire through Lever, with salary ranges where the employer publishes them. Don't use when: you need a keyword search across all employers, boards on other hiring systems, or candidate profiles. First call (answers 402 with the price and payment details): curl -i "https://johto-x402-api.johtodata.workers.dev/v1/jobs?companies=lever:zoox&days=7&limit=10&title=engineer" Example request: `/v1/jobs?companies=lever:zoox&days=7&limit=10&title=engineer` Example response (live, 1 row): {"data":[{"ats":"lever","company":"zoox","employmentType":"Full-time","id":"lever:8befaec7-bb9f-4cf3-a48c-46b5e3886bf3","isRemote":false,"jobUrl":"https://jobs.lever.co/zoox/8befaec7-bb9f-4cf3-a48c-46b5e3886bf3","location":"Foster City, CA","postedAt":"2026-10-21T17:34:11.949Z","salaryCurrency":"USD","salaryMax":168000,"salaryMin":123000,"title":"Administrative Business Partner, Product"}],"rows":1}

Os preços são por chamada em USDC na Base. A resposta de pagamento 402 de cada rota é a referência oficial.

Compre em uma chamada

Teste grátis: adicione ?sample=1 a qualquer rota para receber um registro real armazenado. Sem pagamento, sem chave.
Chame a rota com seus parâmetros de consulta. Ela responde 402 Payment Required com o preço, o valor em USDC na Base e o endereço de pagamento, no cabeçalho PAYMENT-REQUIRED e no corpo JSON.
Seu cliente x402 assina o pagamento em USDC e repete a mesma requisição com o cabeçalho de pagamento. Você recebe JSON: { data, rows } .
Sem cobrança se nada corresponder, se a fonte estiver fora do ar ou se a entrada for inválida (400).

Qualquer cliente x402 funciona, por exemplo x402-fetch (wrapFetchWithPayment) ou x402-axios com uma carteira Base com USDC. Esquema completo: openapi.json .

Pedidos diretos

Pacotes e feeds de dados: peça em /order/ e pague em USDC na Base, como nas rotas de API acima.

Lista legível por máquina: /.well-known/x402 . Prefere a Apify? Veja a documentação dos Actors . Dúvidas: sales@johtodata.com .