fittings-gov-federal-spending

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

US federal spending by recipient

按受助方查询美国联邦支出

gov.federal-spending
on
https://fittings.sh
. One endpoint, government and civic.
Federal award totals for a recipient name, with award counts and the agencies that paid.
gov.federal-spending
接口位于
https://fittings.sh
。这是一个面向政府与公共领域的单一接口。
按受助方名称统计的联邦奖励总额,包含奖励数量及付款机构。

The call

调用方式

POST https://fittings.sh/v1/gov/federal-spending
FieldTypeRequiredNotes
recipient
stringyesRecipient or company name
limit
numberno1-100, default 10
Example input:
json
{
  "recipient": "Lockheed Martin",
  "limit": 5
}
POST https://fittings.sh/v1/gov/federal-spending
字段类型是否必填说明
recipient
string受助方或公司名称
limit
number取值范围1-100,默认值为10
示例输入:
json
{
  "recipient": "Lockheed Martin",
  "limit": 5
}

Metered

计量计费

The 402 quotes a ceiling — the price of the declared cap, 100 results — and settlement is for what the call actually used. A small request settles for less than it was quoted, so read the quote as an upper bound rather than a price.
402响应会给出一个上限报价——即声明上限(100条结果)对应的价格,而最终结算费用则按实际调用返回的结果数量计算。小请求的结算费用会低于报价,因此请将报价视为最高限价而非固定价格。

Cost and provenance

费用与数据源

Price$0.004 per call, metered per results
SourceUSAspending.gov API, public domain
Licencepublic-domain
价格每次调用0.004美元,按返回结果数量计量计费
数据源USAspending.gov API,属于公有领域
许可证公有领域

Why call it rather than answer from memory

为何调用该接口而非依赖模型记忆

A procurement or diligence agent checking whether a counterparty depends on federal contracts needs the award record, and no model holds it.
采购或尽职调查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/gov.federal-spending | 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
该Skill为独立加载,因此本文档本身即可提供完整指导,无需假设已加载通用的
fittings
Skill。
call.mjs
文件与本文档一同发布;若缺少该文件(即您仅收到本文档而未获取完整Skill),可通过以下命令一次性获取:
curl -sO https://fittings.sh/skill/call.mjs
免费调用,无需钱包。查看接口schema并了解调用成本:
bash
curl -s https://fittings.sh/catalog/gov.federal-spending | jq
付费调用。该接口会返回
402 Payment Required
响应及签名报价,您需签署授权,由服务商完成结算——您无需发送交易,也无需支付gas费用。在产生任何支出前,客户端会将自身哈希与网关进行校验,若网关逻辑已更新则会拒绝签署:
bash
undefined

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

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

node call.mjs gov.federal-spending recipient="Lockheed Martin" limit=5
node call.mjs gov.federal-spending recipient="Lockheed Martin" limit=5

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

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

export FITTINGS_PRIVATE_KEY=0x... node call.mjs gov.federal-spending recipient="Lockheed Martin" limit=5

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 gov.federal-spending recipient="Lockheed Martin" limit=5

仅当您主动设置密钥时才会产生支出:未设置`FITTINGS_PRIVATE_KEY`时,客户端仅获取报价后即停止操作。`FITTINGS_MAX_PRICE`可设置自动支付的最高限额,默认值为0.05美元。

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

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

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