# Vellum Filing Delta

> Vellum Filing Delta is a paid API for AI agents from x402-data-api.x402agent.workers.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-13).

Returns only new SEC filings and changed XBRL financial figures for a company within a date window, including previous values and percentage moves — optimized for cheap polling of a watchlist.

## Facts

- Endpoint: GET https://x402-data-api.x402agent.workers.dev/filing-delta?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vellum-filing-delta-98a35676
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Nka5b33CCGZkPAEwQtwGa

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 vellum-filing-delta-98a35676
```

Example prompt: Pull the filing delta for Microsoft (CIK 0000789019) over the last 30 days — show me any new filings and which XBRL financial figures they re-reported, along with the previous values and percentage changes.

## When to prefer this

Choose this endpoint when you need to efficiently poll one or more companies for changes since your last check — it returns only the delta (new filings + re-reported financials with prior values) rather than a full snapshot, making it far cheaper for recurring watchlist monitoring. Prefer it over vellum-filing-brief or vellum-sec-research when you already have baseline data and only want incremental changes.

## Known failure modes

- Invalid or unknown CIK/ticker returns empty result or error
- Date window too narrow returns no changes even if filings exist
- EDGAR rate limits or downtime cause upstream fetch failures
- XBRL tags not present in filings yield empty updated_financials array
- Payment of $0.25 USDC not completed results in 402 rejection

## How this service works

SEC filing delta since a date: new filings, form counts, updated financial facts and change signals for monitoring agents.

## Output

A JSON object containing: the date window queried, company identity (CIK, name, ticker), a boolean 'changed' flag, a human-readable signals array summarizing key changes, a list of new filings with form type and URL, and a list of updated XBRL financial figures each showing the current value, previous reported value, and percentage change.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-09-18T22:40:00.000Z",
  "brand": "Vellum",
  "source": "SEC EDGAR",
  "window": {
   "days": 30,
   "since": "2026-08-19",
   "until": "2026-09-18"
  },
  "changed": true,
  "company": {
   "cik": "0000789019",
   "name": "Microsoft Corp",
   "ticker": "MSFT"
  },
  "service": "filing-delta",
  "signals": [
   "1 new filing(s) since 2026-08-19",
   "1× 8-K",
   "revenue +7.62% versus the prior reported period"
  ],
  "new_filings": [
   {
    "url": "https://www.sec.gov/Archives/edgar/data/789019/...",
    "form": "8-K",
    "filed": "2026-08-27",
    "period": "2026-08-27"
   }
  ],
  "updated_financials": [
   {
    "tag": "RevenueFromContractWithCustomerExcludingAssessedTax",
    "unit": "USD",
    "label": "Revenues",
    "current": {
     "form": "10-K",
     "filed": "2026-07-30",
     "value": 69632000000,
     "period_end": "2026-06-30"
    },
    "change_pct": 7.62,
    "previous_reported": {
     "form": "10-Q",
     "filed": "2026-04-30",
     "value": 64703000000,
     "period_end": "2026-03-31"
    }
   }
  ],
  "new_filings_by_form": {
   "4": 3,
   "8-K": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vellum-filing-delta-98a35676/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-data-api.x402agent.workers.dev](https://www.zero.xyz/host/x402-data-api.x402agent.workers.dev/llms.txt)