Hacker News Frontpage

Preview request

The preview path is rate-limited and does not charge. It executes the live source and returns the paid response shape while withholding decision-ready values. Production requests use the same parameters and return a standard x402 challenge when no payment signature is present.

curl --request GET \
  "https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/hacker_news_top?preview=true&limit=2"

Input contract

Example deliverable

This is the documented response shape, not a promise that live values will match the example. The paid request returns current or declared-source results using the same contract.

{
  "success": true,
  "source": "Hacker News Firebase API",
  "fetched_at": "2026-08-07T07:32:38.144Z",
  "count": 2,
  "data": [
    {
      "id": 49201970,
      "title": "AMD acquires Taalas to boost inference performance by etching models in silicon",
      "url": "https://www.theregister.com/systems/2026/08/06/amd-acquires-ai-chip-startup-taalas-to-boost-inference-performance-by-etching-models-into-silicon/5284344",
      "discussion_url": "https://news.ycombinator.com/item?id=49201970",
      "score": 591,
      "comments": 444,
      "author": "itvision",
      "created_at": "2026-08-06T20:23:11.000Z"
    },
    {
      "id": 49202690,
      "title": "What Is a Product?",
      "url": "https://roge.onwrite.app/what-is-a-product",
      "discussion_url": "https://news.ycombinator.com/item?id=49202690",
      "score": 19,
      "comments": 6,
      "author": "rogix",
      "created_at": "2026-08-06T21:16:52.000Z"
    }
  ],
  "marketplace_metadata": {
    "data_mode": "live_source",
    "billable": true,
    "availability": "operational",
    "source": "Hacker News Firebase API"
  }
}

Purchase decision

Buy when: the active task needs this product's structured result, its declared source and freshness are sufficient, and 0.02 USDC is within the buyer's authorized per-request limit.

Skip when: a cached result is sufficient, the source or fields do not satisfy the task, or the buyer has not authorized payment. Do not bypass wallet, budget, or user-approval policy.

Guaranteed response metadata

Every successful product response identifies how the result was produced. Product-specific output fields are documented in the paid OpenAPI contract. The preview proves the live source and field types without returning the paid values.

{
  "marketplace_metadata": {
    "data_mode": "live_source",
    "billable": true,
    "availability": "operational",
    "source": "Hacker News Firebase API"
  }
}

Agent payment flow

Fast path: install the public MCP package, configure a dedicated low-balance Base buyer wallet and a maximum per-request spend, then call this tool with auto_pay: true. The client handles the challenge, local signature, settlement, and retry in one tool call.

npx -y dopaminedesk-ai-data-marketplace-mcp

X402_AUTO_PAY=true
X402_EVM_PRIVATE_KEY=<dedicated buyer wallet key>
X402_MAX_PAYMENT_USDC=0.25

tool input: { "auto_pay": true }

Manual path: request the product, read the base64 PAYMENT-REQUIRED challenge, sign with any compatible x402 v2 client, and retry with PAYMENT-SIGNATURE. A successful response includes PAYMENT-RESPONSE.