REST API/capital-change-brief
GET

/stocks/{ticker}/capital-change-brief

10 cr

Compose the current reported ownership change for one ticker: which tracked 13F managers initiated, added, reduced, or exited; whether qualifying Form 4 open-market activity corroborates the direction; what coverage limits apply; and which SEC filings support each claim. Current-only. Ticker is the only input. Coverage is limited to securities resolvable in Arkolith's tracked SEC corpus, and partial, uncertain, no_data, or refused are explicit outcomes rather than guessed answers.

Request#

bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://arkolith.com/api/v1/stocks/AAPL/capital-change-brief"

Parameters#

ParameterInTypeDescription
tickerreqpathstringExchange ticker, e.g. MREO or BRK.B

Example response#

json
{
  "data": {
    "schema_version": "capital_change_brief.v1",
    "outcome": "partial",
    "current_only": true,
    "generated_at": "2026-07-15T12:00:00.000Z",
    "requested_ticker": "MREO",
    "brief_id": "ccm_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
    "entity": {
      "ticker": "MREO",
      "name": "MEREO BIOPHARMA GROUP PLC",
      "cusip": "589492107"
    },
    "headline": "One tracked manager reported a higher quarter-end position in MREO; no qualifying Form 4 activity was found in the window.",
    "explanation": "The institutional leg compares each manager's latest effective 13F book with its prior comparable filing. The insider leg checks qualifying open-market Form 4 transactions over 180 days.",
    "institutional": {
      "stance": "net_increases",
      "ranking_basis": "absolute_reported_share_change",
      "changes": [
        {
          "fund": {
            "name": "BANK OF AMERICA CORP /DE/",
            "cik": "0000070858",
            "slug": "bank-of-america-corp-de-70858"
          },
          "action": "added",
          "quarter_end": "2026-03-31",
          "current_shares": "8190000",
          "previous_shares": "100000",
          "share_delta": "8090000",
          "pct_delta": 8090,
          "current_value_usd": 2700000,
          "published_at": {
            "value": "2026-05-15",
            "precision": "date"
          },
          "quality": {
            "status": "clear",
            "reasons": []
          },
          "evidence_ids": [
            "sec:13f:0000070858-26-000001",
            "sec:13f:0000070858-25-000001"
          ],
          "amendment": {
            "is_amendment": false,
            "amendment_type": null
          }
        }
      ],
      "counts": {
        "initiated": 0,
        "added": 1,
        "reduced": 0,
        "exited": 0,
        "unchanged": 0,
        "baseline_only": 0
      },
      "latest_reported_quarter_end": "2026-03-31",
      "tracked_managers_observed": 1,
      "periods_observed": [
        {
          "quarter_end": "2026-03-31",
          "managers": 1
        }
      ],
      "stale_manager_observations": 0
    },
    "insiders": {
      "stance": "none_found",
      "window_days": 180,
      "window_start": "2026-01-16",
      "window_end": "2026-07-15",
      "transactions": [],
      "counts": {
        "buys": 0,
        "sells": 0,
        "distinct_buyers": 0,
        "distinct_sellers": 0,
        "priced": 0,
        "unpriced": 0
      }
    },
    "corroboration": "not_comparable",
    "quality_artifacts": {
      "suppresses_direction": false,
      "uncertain_observations": 0,
      "example_limit_per_group": 1,
      "evidence_id_limit_per_example": 4,
      "groups": []
    },
    "coverage": {
      "thirteen_f": {
        "corpus": "Arkolith tracked 13F corpus",
        "status": "available",
        "latest_quarter_filing_window": "open",
        "latest_reported_quarter_end": "2026-03-31",
        "managers_with_comparable_change": 1,
        "baseline_observations": 0,
        "observations_scanned": 1,
        "observations_displayed": 1,
        "observations_total": 1,
        "periods_observed": [
          {
            "quarter_end": "2026-03-31",
            "managers": 1
          }
        ],
        "stale_manager_observations": 0,
        "truncated": false
      },
      "form4": {
        "status": "complete",
        "coverage_start": "2024-01-01",
        "indexed_through": "2026-07-15",
        "window_start": "2026-01-16",
        "window_end": "2026-07-15",
        "truncated": false
      },
      "limitations": [
        "The latest reported quarter is still inside the statutory 13F filing window.",
        "13F positions are quarter-end disclosures, not exact trade dates.",
        "Rich evidence objects are limited to displayed changes and bounded quality-artifact examples; manifest.evidence_ids retains complete stable IDs for the bounded aggregate."
      ]
    },
    "evidence": [
      {
        "evidence_id": "sec:13f:0000070858-25-000001",
        "kind": "sec_13f",
        "source": "SEC EDGAR 13F",
        "accession_number": "0000070858-25-000001",
        "form_type": "13F-HR",
        "source_url": "https://www.sec.gov/Archives/edgar/data/70858/000007085825000001/0000070858-25-000001-index.html",
        "human_url": "https://www.sec.gov/Archives/edgar/data/70858/000007085825000001/0000070858-25-000001-index.html",
        "published_at": {
          "value": "2025-11-14",
          "precision": "date"
        },
        "retrieved_at": "2025-11-14T20:00:00.000Z",
        "parser_version": "13f-v3",
        "raw_hash": null
      },
      {
        "evidence_id": "sec:13f:0000070858-26-000001",
        "kind": "sec_13f",
        "source": "SEC EDGAR 13F",
        "accession_number": "0000070858-26-000001",
        "form_type": "13F-HR",
        "source_url": "https://www.sec.gov/Archives/edgar/data/70858/000007085826000001/0000070858-26-000001-index.html",
        "human_url": "https://www.sec.gov/Archives/edgar/data/70858/000007085826000001/0000070858-26-000001-index.html",
        "published_at": {
          "value": "2026-05-15",
          "precision": "date"
        },
        "retrieved_at": "2026-05-15T20:00:00.000Z",
        "parser_version": "13f-v3",
        "raw_hash": null
      }
    ],
    "evidence_scope": {
      "object_scope": "displayed_changes_and_material_quality_artifacts",
      "returned_object_count": 2,
      "manifest_evidence_id_count": 2,
      "aggregate_claim_evidence_ids_complete": true
    },
    "manifest": {
      "manifest_id": "ccm_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
      "algorithm_version": "1.2.0",
      "current_only": true,
      "parameters": {
        "ticker": "MREO",
        "form4_window_days": 180,
        "max_institutional_changes": 8,
        "max_insider_transactions": 8,
        "window_start": "2026-01-16",
        "window_end": "2026-07-15"
      },
      "quality": {
        "outcome": "partial",
        "thirteen_f_status": "available",
        "form4_status": "complete",
        "institutional_truncated": false,
        "form4_truncated": false
      },
      "evidence_ids": [
        "sec:13f:0000070858-25-000001",
        "sec:13f:0000070858-26-000001"
      ],
      "claims": [
        {
          "claim_id": "claim_0123456789abcdef01234567",
          "kind": "institutional_change",
          "evidence_ids": [
            "sec:13f:0000070858-25-000001",
            "sec:13f:0000070858-26-000001"
          ]
        },
        {
          "claim_id": "claim_89abcdef0123456789abcdef",
          "kind": "corroboration",
          "evidence_reference": {
            "field": "manifest.evidence_ids",
            "evidence_id_count": 2
          }
        }
      ]
    },
    "disclaimer": "Reported filing changes are not real-time trades or investment advice."
  }
}

MCP equivalent: capital_change_brief. The full agent surface lives on the MCP server.