Documentación / API para agentes

API para agentes

Rutas de datos de pago por llamada para agentes de IA. Pague cada solicitud en USDC en Base con x402. Sin cuenta, sin clave de API.

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

Precio	Ruta, campos y ejemplo
$0.002 por llamada	`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 llamada	`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 llamada	`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 llamada	`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 llamada	`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 llamada	`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 llamada	`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 llamada	`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 llamada	`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 llamada	`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 llamada	`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 llamada	`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 llamada	`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}

Los precios son por llamada, en USDC en Base. La respuesta de pago 402 de cada ruta es la referencia válida.

Compre en una llamada

Pruébelo gratis: añada ?sample=1 a cualquier ruta y reciba un registro real almacenado. Sin pago, sin clave.
Llame a la ruta con sus parámetros de consulta. Responde 402 Payment Required con el precio, el importe en USDC en Base y la dirección de pago, en la cabecera PAYMENT-REQUIRED y en el cuerpo JSON.
Su cliente x402 firma el pago en USDC y repite la misma solicitud con la cabecera de pago. Recibe JSON: { data, rows }.
No se cobra si no hay resultados, si la fuente no está disponible o si la entrada no es válida (400).

Funciona con cualquier cliente x402, por ejemplo x402-fetch (wrapFetchWithPayment) o x402-axios con una wallet de Base que tenga USDC. Esquema completo: openapi.json.

Pedidos directos

Paquetes y feeds de datos: haga su pedido en /order/ y pague con factura por tarjeta o en cripto, todo a una sola dirección: USDC en Ethereum, Base, Arbitrum, Optimism o Polygon; USDT en Ethereum; ETH en Ethereum, Base, Arbitrum u Optimism; POL en Polygon. Envíe solo por las redes indicadas. La misma dirección en todas las redes indicadas. Las rutas de API de arriba solo aceptan USDC en Base.

Lista legible por máquina: /.well-known/x402. ¿Prefiere Apify? Consulte la documentación de los Actors. Preguntas: sales@johtodata.com.