← TradeDataHub

Interactive Contractor Data API Documentation

Free, unauthenticated discovery. Try real read-only requests without purchasing anything or revealing protected data.

OpenAPI 3.110 live states35,113 catalog recordsTestnet x402 only

Try the live discovery API

Every request on this page is a GET to a public discovery endpoint. Results are JSON. No Stripe checkout is launched, API credits are consumed, or private records are requested.

Request: /api/v1/coverage

No request yet.

Click "Run public GET request" to view JSON.

Agent discovery and machine-readable schemas

Agent catalog (llms.txt) · Full agent guide · OpenAPI JSON specification · Developer quickstart.

Texas masked teaser contains only availability samples. Contact identities and purchased CSV records are excluded from public previews.

Paid subscription API (requires your own key)

API Starter $39/month and Agency $99/month use Authorization: Bearer YOUR_API_KEY. A successful paid record response consumes contractor-row credits. To avoid accidental usage, this public interactive explorer never sends authentication headers and never calls paid record endpoints.

curl -i "https://www.tradedatahub.net/api/access/v1/status" -H "Authorization: Bearer YOUR_API_KEY"
curl -i "https://www.tradedatahub.net/api/access/v1/datasets/PRODUCT_ID/records?limit=100&offset=0" -H "Authorization: Bearer YOUR_API_KEY"

Separate x402 integration-test rail

The optional HTTP 402 paid-retrieval challenge uses Base Sepolia (eip155:84532) testnet USDC only. No mainnet x402 settlement or Stripe MPP production approval is claimed. Existing human Stripe purchasing is a separate process.