# FundFlow – Institutional 13F Ownership & Flow

> FundFlow – Institutional 13F Ownership & Flow is a paid API for AI agents from funds.lonestaroracle.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns SEC 13F-based institutional ownership data and a quarter-over-quarter flow signal (ACCUMULATION/NEUTRAL/DISTRIBUTION) for a given stock ticker

## Facts

- Endpoint: GET https://funds.lonestaroracle.xyz/funds
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fundflow-institutional-13f-ownership-flow-4ed75916
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_odw5GOdmPAHzGlmDEBQMZ

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 fundflow-institutional-13f-ownership-flow-4ed75916
```

Example prompt: What are the big institutions doing with Nvidia — are they accumulating or distributing, and who are the top holders right now?

## When to prefer this

Choose FundFlow when you need a structured, per-call read on institutional 13F positioning for a US-listed equity — specifically the flow direction (accumulation vs. distribution), top holder breakdown, and ownership percentages. Prefer this over manual SEC EDGAR lookups or premium data terminals when you want a lightweight, pay-per-call API ($0.05 USDC) that aggregates and interprets quarterly filings. Note the inherent quarterly lag and long-only scope (no shorts/derivatives reported).

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty result
- Very small-cap stocks with few 13F filers may return sparse holder data
- Data is lagged by ~45 days after quarter-end — real-time positioning is not available
- Non-US-listed equities are not covered by 13F filings and will not return results
- Payment failure or insufficient USDC balance blocks the call via x402 protocol

## How this service works

Institutional (13F) ownership & flow for a stock (?ticker=<stock ticker>)

## Output

A JSON object containing: the stock ticker and company name, a flow signal (ACCUMULATION, NEUTRAL, or DISTRIBUTION), total institutional ownership percentage, insider ownership percentage, total institution count, a list of top holders each tagged with their action (added/trimmed/held/new), position value in USD billions, and percent held, plus a human-readable interpretation of the quarter's flow. Data is sourced from SEC 13F filings via yfinance and reflects the most recently filed quarter (lagged ~45 days after quarter-end).

## Request schema (JSON Schema)

```json
{
 "name": "FundFlow",
 "tags": [
  "13f",
  "institutional",
  "ownership",
  "smart-money",
  "equities"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "markets",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "ticker": {
       "type": "string",
       "example": "NVDA",
       "description": "Stock ticker to read institutional 13F flow for (e.g. AAPL, NVDA, GME). Aliases: symbol."
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "as_of": "2026-03-31",
     "source": "yfinance (SEC 13F institutional holdings)",
     "ticker": "GME",
     "company": "GameStop Corporation",
     "flow_signal": "ACCUMULATION",
     "top_holders": [
      {
       "as_of": "2026-03-31",
       "action": "added",
       "holder": "Blackrock Inc.",
       "pct_held": 8,
       "value_usd_bn": 1.2,
       "qoq_change_pct": 1.7
      }
     ],
     "flow_summary": {
      "added": 7,
      "trimmed": 1,
      "new_unverified": 2,
      "top_holders_shown": 10
     },
     "interpretation": "Institutions leaned to accumulation last quarter — 7 of the top 10 holders added, 1 trimmed.",
     "institutions_count": 482,
     "insider_ownership_pct": 8.2,
     "institutional_ownership_pct": 37.1
    }
   }
  }
 },
 "description": "Institutional 13F ownership and flow made agent-callable. One x402 call takes a stock ticker and returns a flow read (ACCUMULATION / NEUTRAL / DISTRIBUTION) from how the top institutional holders changed their positions quarter-over-quarter, plus total institutional ownership percent and count, insider ownership, and the top holders each tagged added / trimmed / held / new. The 'what are the big funds doing' read a trading or research agent needs, served pay-per-call. $0.05 in USDC on Base via x402. Source: yfinance aggregation of SEC 13F filings (free/public). NOTE: 13F is filed quarterly, ~45 days after quarter-end, so this is last-quarter positioning (lagged), and it covers long US equity positions only (no shorts or derivatives). Companion to EquityScope, AnalystEdge, Ins
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fundflow-institutional-13f-ownership-flow-4ed75916/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from funds.lonestaroracle.xyz](https://www.zero.xyz/host/funds.lonestaroracle.xyz/llms.txt)