fittings-sec-company-facts

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SEC XBRL company financial facts

SEC XBRL 公司财务事实数据

sec.company-facts
on
https://fittings.sh
. One endpoint, finance and markets.
Structured XBRL financial facts for a company by CIK: revenue, assets, cash and every other tagged concept as reported.
sec.company-facts
接口位于
https://fittings.sh
。这是一个专注于金融与市场领域的单一接口。
通过CIK获取公司的结构化XBRL财务事实数据:包括营收、资产、现金以及其他所有已标记的申报概念。

The call

调用方式

GET https://fittings.sh/v1/sec/company-facts
FieldTypeRequiredNotes
cik
stringyesCompany CIK, padded or bare
concept
stringyesUS-GAAP concept, e.g. Revenues or Assets
Example input:
json
{
  "cik": "0000320193",
  "concept": "Assets"
}
GET https://fittings.sh/v1/sec/company-facts
字段类型是否必填说明
cik
string公司CIK,可带补位零或直接使用原始值
concept
stringUS-GAAP概念,例如Revenues或Assets
示例输入:
json
{
  "cik": "0000320193",
  "concept": "Assets"
}

Cost and provenance

费用与数据来源

Price$0.005
SourceSEC EDGAR XBRL companyconcept API (data.sec.gov), public domain
Licencepublic-domain
价格$0.005
数据源SEC EDGAR XBRL companyconcept API(data.sec.gov),属于公有领域
许可证公有领域

Why call it rather than answer from memory

为何调用该接口而非依赖记忆回答

An analysis agent needs the number a company actually filed, tagged and dated, rather than a figure recalled from training data that may be a year stale.
分析Agent需要的是公司实际申报、标记并带有日期的数据,而非可能已过时一年的训练数据中的数值。

Calling it

调用指南

A skill is loaded on its own, so this document has to be enough by itself. It does not assume the general
fittings
skill is also loaded.
call.mjs
ships alongside this file; if it is missing (this document reached you without the rest of the skill), fetch it once with
curl -sO https://fittings.sh/skill/call.mjs
.
Free, and needs no wallet. Read the schema and see what a call would cost:
bash
curl -s https://fittings.sh/catalog/sec.company-facts | jq
Paying. The endpoint answers
402 Payment Required
with a signed quote, you sign an authorization, and a facilitator settles it — you never send a transaction and never pay gas. Before it spends anything, the client checks its own hash against the gateway and refuses rather than sign with logic the gateway has moved past:
bash
undefined
该技能为独立加载,因此本文档本身需包含所有必要信息,无需依赖通用的
fittings
技能。
call.mjs
文件与本文档一同提供;若缺失(即您仅收到本文档而未获取技能的其余部分),可通过以下命令一次性获取:
curl -sO https://fittings.sh/skill/call.mjs
免费操作,无需钱包。查看接口schema并了解调用费用:
bash
curl -s https://fittings.sh/catalog/sec.company-facts | jq
付费调用。该端点会返回
402 Payment Required
状态码及已签名的报价,您需签署授权信息,由服务商完成结算——您无需发送交易,也无需支付gas费。在产生任何费用前,客户端会将自身哈希与网关进行比对,若网关逻辑已更新则会拒绝签署:
bash
undefined

Dry run. Prints the quote and pays nothing, because no key is set.

试运行。仅打印报价,无需支付费用,因为未设置密钥。

node call.mjs sec.company-facts cik=0000320193 concept=Assets
node call.mjs sec.company-facts cik=0000320193 concept=Assets

For real: a wallet holding USDC on Base, and nothing else.

实际调用:需持有Base链上USDC的钱包,无需其他资产。

export FITTINGS_PRIVATE_KEY=0x... node call.mjs sec.company-facts cik=0000320193 concept=Assets

Spending is never a side effect of curiosity: with no `FITTINGS_PRIVATE_KEY`
the client fetches the quote and stops. `FITTINGS_MAX_PRICE` caps what it will
pay without asking, and defaults to $0.05.

**Use a throwaway wallet holding a few dollars, not a main one.** The key sits
in plaintext wherever the agent runs, and the whole cost of entry is USDC on
Base — no account, no API key, and no ETH, because the payer signs off-chain and
the facilitator broadcasts and pays the gas.

Writing your own client instead of using this one? `@x402/core` and
`@x402/evm` on npm, and the `fittings` skill records the two things that cost
real debugging time: the challenge is in a response header rather than the body,
and it must be re-signed from the exact request being retried.

If this is not the right service, `https://fittings.sh/catalog/search?q=...`
searches all of them for free.
export FITTINGS_PRIVATE_KEY=0x... node call.mjs sec.company-facts cik=0000320193 concept=Assets

仅出于好奇的操作不会产生费用:未设置`FITTINGS_PRIVATE_KEY`时,客户端只会获取报价后停止。`FITTINGS_MAX_PRICE`用于设置无需确认即可支付的最高金额,默认值为0.05美元。

**请使用仅持有少量资金的一次性钱包,而非主钱包**。密钥会以明文形式存储在Agent运行的环境中,入门成本仅为Base链上的USDC——无需账户、无需API密钥、无需ETH,因为付款方进行链下签名,由服务商负责广播交易并支付gas费。

不想使用该客户端,希望自行开发?可使用npm上的`@x402/core`和`@x402/evm`包,`fittings`技能记录了两个耗时调试的关键点:挑战信息位于响应头而非响应体中,且必须针对重试的精确请求重新签名。

若该服务不符合您的需求,可通过`https://fittings.sh/catalog/search?q=...`免费搜索所有可用服务。