commerce

Paid dataset retrieval via x402 (TESTNET ONLY)

x402 paid retrieval. TESTNET ONLY: network is Base Sepolia (eip155:84532); mainnet settlement is NOT enabled. With no PAYMENT-SIGNATURE header the endpoint returns HTTP 402 Payment Required including the current x402 Payment-Required challenge (the server generates it dynamically; do not hardcode it). After a valid TESTNET settlement the endpoint returns 200 with a one-shot authorized download URL. Human Stripe purchasing is a separate, unchanged path. Agents may inspect the 402 challenge without making any payment.

get/api/v1/datasets/{product_id}/download

Request

  • Base URL: https://www.tradedatahub.net
  • URL: https://www.tradedatahub.net/api/v1/datasets/{product_id}/download
  • Auth: none declared

Path parameters

product_idstring required

Canonical product identifier. Formats: state:{state_slug} (e.g. state:texas), state-trade:{state_slug}:{trade_slug} (e.g. state-trade:florida:roofer), city-trade:{state_slug}:{city_slug}:{trade_slug} (e.g. city-trade:texas:austin:plumber), Mega Pack IDs are returned by discovery endpoints and may retain a legacy stable catalog ID for compatibility. Slugs are lowercase hyphenated; always derive product_id values from the discovery endpoints rather than constructing them ad hoc.

Response

Authorized delivery after valid TESTNET settlement (one-shot download URL)

api_versionstring required
product_idstring required
filenamestring
download_urlstring required
record_countinteger

Changes

No recorded changes to this operation across all 1 revision of this API.