# Faelo — machine catalog

Public US-government reference data, sold to AI agents one record at a time over x402.

Every API here serves verbatim public-domain US-government reference data.
Free routes: keyword search and metadata. Paid route: the full record,
gated by x402. Request the paid route, receive HTTP 402 with the price and
terms, pay USDC on Base mainnet (eip155:8453)
through the Coinbase CDP facilitator (x402 v2,
exact scheme), repeat the request, receive the record. The 402
also carries x402 Bazaar discovery data. No account, no API key.

Payout wallet: 0xA40Dadc75B69bEe8325E8089258235213293F8F4
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC)
Structured version of this catalog: https://usefaelo.com/apis.json

## IRS Internal Revenue Bulletin API
Verbatim IRS Revenue Rulings, Revenue Procedures, Notices, and Treasury Decisions since 2003.
The Internal Revenue Bulletin is the IRS's authoritative weekly publication of official guidance. This API serves every document from the 2003-onward HTML era, verbatim, from a structured database. The IRS publishes these only as 1,200+ separate bulletin pages with no per-document search and no per-document retrieval.
Coverage: 6,363 documents across 1,206 bulletin issues
Source: Internal Revenue Service — public-domain US government work
Root: https://irb-precedent-api.canvas-cart.workers.dev
Guide: https://irb-precedent-api.canvas-cart.workers.dev/llms.txt
Ids: a document slug, e.g. "rev-rul-2003-71" or "td-2003-9091"; get it from /search
Routes:
  GET /search?q=<keywords>&limit=<1-50>  [free]
  GET /doc/{id}  [free]
  GET /doc/{id}/full  [PAID $0.01]
Free search example: https://irb-precedent-api.canvas-cart.workers.dev/search?q=research+credit&limit=3
Paid call: request /doc/{id}/full; on 402 pay $0.01 per document; repeat; receive the record.
Sample paid URL: https://irb-precedent-api.canvas-cart.workers.dev/doc/td-2003-9091/full

## IRS Internal Revenue Manual API
The internal procedures IRS staff follow for examinations, collection, appeals, penalties, and disclosure.
The Internal Revenue Manual is the IRS's internal how-to: what an examiner must do, when supervisory approval of a penalty is required, how a case moves to Appeals. It is distinct from the Internal Revenue Bulletin, which publishes new guidance. The IRS serves the IRM as a 26-part HTML navigation tree with no per-section search API.
Coverage: 1,774 sections across 26 published parts
Source: Internal Revenue Service — public-domain US government work
Root: https://irm-api.canvas-cart.workers.dev
Guide: https://irm-api.canvas-cart.workers.dev/llms.txt
Ids: a dotted section locator, e.g. "20.1.1" or "4.10.1"; get it from /search or /part/{number}
Routes:
  GET /search?q=<keywords>&limit=<1-50>  [free]
  GET /part/{number}  [free]
  GET /section/{id}  [free]
  GET /section/{id}/full  [PAID $0.01]
Free search example: https://irm-api.canvas-cart.workers.dev/search?q=supervisory+approval+penalty&limit=3
Paid call: request /section/{id}/full; on 402 pay $0.01 per section; repeat; receive the record.
Sample paid URL: https://irm-api.canvas-cart.workers.dev/section/20.1.1/full

## SSA POMS API
The operational rulebook SSA staff use to decide retirement, disability, SSI, and Medicare claims.
The Program Operations Manual System is the Social Security Administration's primary operational reference. SSA publishes it only as a browseable Lotus Notes manual with no per-section index and no API. This service adds keyword search and per-section retrieval over a structured database.
Coverage: 16,415 sections across 14 parts
Source: Social Security Administration — public-domain US government work
Root: https://poms-api.canvas-cart.workers.dev
Guide: https://poms-api.canvas-cart.workers.dev/llms.txt
Ids: a section id with a space, e.g. "DI 33001.001" or "SI 01110.200"; URL-encode the space as %20; get it from /search or /part/{code}
Routes:
  GET /search?q=<keywords>&limit=<1-50>  [free]
  GET /part/{code}  [free]
  GET /section/{id}  [free]
  GET /section/{id}/full  [PAID $0.01]
Free search example: https://poms-api.canvas-cart.workers.dev/search?q=substantial+gainful+activity&limit=3
Paid call: request /section/{id}/full; on 402 pay $0.01 per section; repeat; receive the record.
Sample paid URL: https://poms-api.canvas-cart.workers.dev/section/DI%2033001.001/full

## FDA Investigations Operations Manual API
The manual FDA field investigators follow when they inspect a facility.
The Investigations Operations Manual is the FDA's primary field guidance for inspections, sample collection, and enforcement procedure. The FDA publishes it as a single large document per chapter with no per-section retrieval. This API serves each section verbatim from a structured database.
Coverage: 546 sections across 10 chapters
Source: Food and Drug Administration — public-domain US government work
Root: https://fda-iom-api.canvas-cart.workers.dev
Guide: https://fda-iom-api.canvas-cart.workers.dev/llms.txt
Ids: a section id, e.g. "chapter-05--5-1-1"; get it from /search or /chapter/{id}
Routes:
  GET /search?q=<keywords>&limit=<1-50>  [free]
  GET /chapter/{id}  [free]
  GET /section/{id}  [free]
  GET /section/{id}/full  [PAID $0.01]
Free search example: https://fda-iom-api.canvas-cart.workers.dev/search?q=credentials&limit=3
Paid call: request /section/{id}/full; on 402 pay $0.01 per section; repeat; receive the record.
Sample paid URL: https://fda-iom-api.canvas-cart.workers.dev/section/chapter-05--5-1-1/full

## HCAD Harris County Property-Tax API
Assessment-protest outcomes and per-parcel value history for every Harris County, Texas parcel. No owner names.
Harris County (Houston) publishes its appraisal roll only as bulk annual downloads with no per-parcel API and no protest-outcome data. This API adds both: for one parcel, every ARB hearing with the value before the protest and the value after, plus the assessed-value series. Owner names and mailing addresses are dropped at ingest and never served.
Coverage: 1.6 million parcels; protest outcomes 2005-2026, values 2015-2026
Source: Harris County Appraisal District — Texas public record (Tex. Gov't Code ch. 552; Tex. Tax Code 25.027)
Root: https://hcad-api.canvas-cart.workers.dev
Guide: https://hcad-api.canvas-cart.workers.dev/llms.txt
Ids: a 13-digit HCAD account number, e.g. "0010090000001"; get it from /search?addr=
Routes:
  GET /search?addr=<street>&limit=<n>  [free]
  GET /parcel/{acct}  [free]
  GET /parcel/{acct}/history  [PAID $0.02]
  GET /parcel/{acct}/protests  [PAID $0.03]
  GET /area/{neighborhood}/protest-stats  [PAID $0.05]
Free search example: https://hcad-api.canvas-cart.workers.dev/search?addr=COMMERCE+ST&limit=3
Paid call: request /parcel/{acct}/protests; on 402 pay $0.02-$0.05 per call; repeat; receive the record.
Sample paid URL: https://hcad-api.canvas-cart.workers.dev/parcel/0010090000001/protests

## Paying code sample (any API, @x402/fetch)

import { wrapFetchWithPayment, x402HTTPClient } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const signer = privateKeyToAccount(process.env.PRIVATE_KEY); // a funded Base wallet
const client = new x402Client();
client.register("eip155:*", new ExactEvmScheme(signer));

const fetchWithPayment = wrapFetchWithPayment(fetch, client);
const httpClient = new x402HTTPClient(client);

const res = await fetchWithPayment("https://irb-precedent-api.canvas-cart.workers.dev/doc/td-2003-9091/full");
const out = await httpClient.processResponse(res);
console.log(out.paymentStatus, out.body);