ドキュメント / エージェントAPI

エージェントAPI

AIエージェント向けの従量課金データルート。各リクエストをx402でBase上のUSDCで支払います。アカウントもAPIキーも不要。

ベースURL:https://johto-x402-api.johtodata.workers.dev

価格ルート、項目、例
$0.002/回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/回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/回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/回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/回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/回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/回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/回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/回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/回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/回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/回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/回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}

価格は1回の呼び出しあたりのBase上のUSDCです。各ルートの402支払いレスポンスが正式な価格です。

1回の呼び出しで購入

  1. 無料で試す:任意のルートに?sample=1を付けると、保存済みの実データ1件を返します。支払いもキーも不要。
  2. クエリパラメーターを付けてルートを呼び出します。PAYMENT-REQUIREDヘッダーとJSON本文で、価格、Base上のUSDC金額、支払先アドレスとともに402 Payment Requiredを返します。
  3. x402クライアントがUSDCの支払いに署名し、支払いヘッダーを付けて同じリクエストを再送します。JSONが返ります:{ data, rows } 。
  4. 該当なし、ソースの停止、または無効な入力(400)の場合は課金されません。

どのx402クライアントでも使えます。例:x402-fetch(wrapFetchWithPayment)、またはUSDCを保有するBaseウォレットとx402-axios。完全なスキーマ:openapi.json 。

直接注文

データパックとフィード:/order/ で注文し、上記のAPIルートと同じくBase上のUSDCでお支払いください。

機械可読の一覧:/.well-known/x402 。Apifyをご希望ですか?Actorのドキュメント をご覧ください。お問い合わせ:sales@johtodata.com 。