Finance frames API

One SEC XBRL tag across every filer for a calendar period, largest value first.

Ask your agent

“Call finance/frames with tag Revenues and summarize what comes back.”

Works in any MCP client connected to https://data.openkrill.app/mcp. Install in one line.

Path: finance/frames
MCP tool: call_endpoint
Credits: 5
Cache: 30 min

Parameters

tagstring, required	us-gaap tag, such as Revenues
periodstring, optional	Calendar frame, such as CY2024Q4I or CY2024, default CY2024Q4I
limitinteger, optional	1-40 companies, default 10

Response

data.resources[] uses the same keys as every other platform: author, engagement, metadata, with Finance-only fields under extras. A failed upstream call is never billed.

More Finance tools

MCP tool call

{
  "name": "call_endpoint",
  "arguments": {
    "path": "finance/frames",
    "params": {
      "tag": "Revenues"
    }
  }
}

curl

curl "https://data.openkrill.app/v1/finance/frames?tag=Revenues" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "success": true,
  "platform": "finance",
  "endpoint": "finance/frames",
  "data": {
    "resources": [
      { "id": …, "title": …, "text": …, "url": …,
        "author": {…}, "engagement": {…},
        "metadata": {…}, "extras": {…} }
    ]
  },
  "credits_used": 5,
  "cached": false
}