# Johto Data API – SEC 13F Holdings Lookup

> Johto Data API – SEC 13F Holdings Lookup is a paid API for AI agents from johto-x402-api.johtodata.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-28).

Retrieves SEC 13F-HR institutional investment holdings for a fund or manager, ranked by portfolio value, given a CIK number or stock ticker.

## Facts

- Endpoint: GET https://johto-x402-api.johtodata.workers.dev/v1/sec-13f?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/johto-data-api-sec-13f-holdings-lookup-e05b8cd6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EOwCux1o6wXnqVEAHvFZH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability johto-data-api-sec-13f-holdings-lookup-e05b8cd6
```

Example prompt: Pull the latest SEC 13F holdings for Berkshire Hathaway — use ticker BRK-B — and show me the top 10 positions by value.

## When to prefer this

Choose this endpoint when you need structured, ranked institutional 13F holdings data for a specific fund — especially when you want to look up by ticker symbol rather than CIK, need pagination over large portfolios, or want per-holding metadata like voting discretion and portfolio percentage. It's billed only on successful data return, making it cost-efficient for exploratory queries. Prefer it over scraping SEC EDGAR directly for speed and structured JSON output.

## Known failure modes

- Invalid or non-existent CIK returns empty data array with rows=0
- Supplying both cik and ticker simultaneously may cause a validation error
- Accession number format mismatch (not matching ^[0-9]{10}-[0-9]{2}-[0-9]{6}$) returns an error
- Fund has not filed a 13F (e.g., manages under $100M threshold) — returns no data
- Offset beyond available holdings count returns empty data
- Payment failure or insufficient USDC balance prevents the call from completing; no charge is applied if fetch fails

## How this service works

Valuable data. Quality leads. Paid per call in USDC on Base via x402. Not charged if the fetch fails or nothing matches. Prices per call (USDC): /v1/jp-invoice-check $0.002; /v1/sec-13f $0.003; /v1/sec-8k $0.003; /v1/sanctions-screen $0.0025; /v1/tenders $0.011; /v1/uk-tenders $0.003; /v1/fr-tenders $0.006; /v1/au-contracts $0.0035; /v1/wallet-risk $0.0025; /v1/kyb $0.0029; /v1/read $0.0019; /v1/crawl $0.0045; /v1/jobs $0.01; /v1/domain-profile $0.003.

## Output

Returns a paginated array of holdings entries, each containing issuer name, CUSIP, share count, USD market value, percentage of portfolio, report quarter, filing date, filer CIK and name, share type, voting authority breakdown, investment discretion classification, a link to the SEC accession index, and the info table XML URL. Also returns total row count and the timestamp the data was fetched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "cik": {
       "type": "string",
       "pattern": "^[0-9]{1,10}$",
       "description": "Filer SEC CIK, 1-10 digits (pass cik or ticker, not both)"
      },
      "limit": {
       "type": "string",
       "pattern": "^([1-9]|[1-9][0-9]|100)$",
       "description": "Holdings 1-100, largest by value first (default 25)"
      },
      "offset": {
       "type": "string",
       "pattern": "^(0|[1-9][0-9]{0,6})$",
       "description": "Holdings to skip, for paging (default 0)"
      },
      "ticker": {
       "type": "string",
       "pattern": "^[A-Za-z][A-Za-z0-9.-]{0,9}$",
       "description": "Filer ticker, e.g. BRK-B (pass cik or ticker, not both)"
      },
      "accession": {
       "type": "string",
       "pattern": "^[0-9]{10}-[0-9]{2}-[0-9]{6}$",
       "description": "13F-HR or 13F-HR/A accession number of this filer"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "rows",
      "fetchedAt"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "rank": {
          "type": "integer"
         },
         "cusip": {
          "type": "string"
         },
         "issuer": {
          "type": "string"
         },
         "shares": {
          "type": "integer"
         },
         "filedAt": {
          "type": "string"
         },
         "putCall": {},
         "filerCik": {
          "type": "string"
         },
         "formType": {
          "type": "string"
         },
         "valueUsd": {
          "type": "integer"
         },
         "filedDate": {
          "type": "string"
         },
         "filerName": {
          "type": "string"
         },
         "reportDate": {
          "type": "string"
         },
         "sharesType": {
          "type": "string"
         },
       
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "rank": 1,
    "cusip": "037833100",
    "issuer": "APPLE INC",
    "shares": 227917808,
    "filedAt": "2026-08-15T00:05:04.000Z",
    "putCall": null,
    "filerCik": "0001067983",
    "formType": "13F-HR",
    "valueUsd": 65950296923,
    "filedDate": "2026-08-14",
    "filerName": "BERKSHIRE HATHAWAY INC",
    "reportDate": "2026-06-30",
    "sharesType": "SH",
    "votingNone": 0,
    "votingSole": 227917808,
    "isAmendment": false,
    "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",
    "titleOfClass": "COM",
    "votingShared": 0,
    "reportQuarter": "2026Q2",
    "pctOfPortfolio": 22.04,
    "positionsCount": 29,
    "accessionNumber": "0001193125-26-352200",
    "portfolioValueUsd": 299253556246,
    "investmentDiscretion": "DFND",
    "otherAmendmentsForPeriod": []
   },
   {
    "rank": 2,
    "cusip": "025816109",
    "issuer": "AMERICAN EXPRESS CO",
    "shares": 151610700,
    "filedAt": "2026-08-15T00:05:04.000Z",
    "putCall": null,
    "filerCik": "0001067983",
    "formType": "13F-HR",
    "valueUsd": 51282319275,
    "filedDate": "2026-08-14",
    "filerName": "BERKSHIRE HATHAWAY INC",
    "reportDate": "2026-06-30",
    "sharesType": "SH",
    "votingNone": 0,
    "votingSole": 151610700,
    "isAmendment": false,
    "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",
    "titleOfClass": "COM",
    "votingShared": 0,
    "reportQuarter": "2026Q2",
    "pctOfPortfolio": 17.14,
    "positionsCount": 29,
    "accessionNumber": "0001193125-26-352200",
    "portfolioValueUsd": 299253556246,
    "investmentDiscretion": "DFND",
    "otherAmendmentsForPeriod": []
   }
  ],
  "rows": 2,
  "fetchedAt": "2026-10-22T11:56:23.942Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/johto-data-api-sec-13f-holdings-lookup-e05b8cd6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from johto-x402-api.johtodata.workers.dev](https://www.zero.xyz/host/johto-x402-api.johtodata.workers.dev/llms.txt)