{
  "schema_version": "sourcestrand-ai-offer-v1",
  "gateway": "SourceStrand Data Gateway",
  "base_url": "https://api.sourcestrand.com",
  "buyer_summary": "Three low-cost x402 paid data products packaged for humans and AI assistants: Taiwan company briefs, Taiwan procurement supplier signals, and Crypto Agent Signal Pack.",
  "fastest_human_path": [
    "Open the homepage and choose the matching product card.",
    "Open a free sample or preview to inspect the JSON shape.",
    "Call the paid endpoint once without payment to receive the x402 402 payload.",
    "Retry with an x402-compatible client and keep the x-buyer-hint header for attribution."
  ],
  "fastest_ai_path": [
    "Fetch /ai-offer.json to enumerate products and endpoint templates.",
    "Fetch a product detail JSON for the selected dataset.",
    "Fetch a free sample or preview before spending.",
    "Use the 402 response from the paid endpoint as the machine-readable payment request."
  ],
  "products": [
    {
      "schema_version": "sourcestrand-product-offer-v1",
      "product_id": "tw_company_intelligence",
      "title": "Taiwan Company Intelligence",
      "service_name": "Taiwan Company Intelligence API",
      "buyer_summary": "Taiwan company brief snapshots packaged as compact JSON for counterparty checks, company profile enrichment, and AI-agent due diligence preflight.",
      "primary_buyer_jobs": [
        "Resolve a Taiwan business_id into a structured company brief.",
        "Give AI assistants source-linked company context before deeper procurement or supplier research.",
        "Keep lineage, limitations, generated_at, valid_until, and source_hash attached to downstream notes."
      ],
      "free_validation": {
        "sample_url": "https://api.sourcestrand.com/samples/tw-company-brief.json",
        "expected_sample_shape": [
          "product",
          "company",
          "signals",
          "data_lineage",
          "limitations",
          "generated_at",
          "valid_until",
          "source_hash"
        ]
      },
      "paid_endpoints": [
        {
          "method": "GET",
          "url_template": "https://api.sourcestrand.com/v1/paid/tw-company/brief?business_id={business_id}",
          "example_url": "https://api.sourcestrand.com/v1/paid/tw-company/brief?business_id=24888323",
          "price": "$0.01",
          "best_first_paid_step": true
        }
      ],
      "connected_products": [
        {
          "product_id": "tw_procurement_supplier_signals",
          "reason": "Use procurement company-activity or supplier-pack when the buyer has a business_id and wants public-sector activity context."
        }
      ],
      "x402_purchase": {
        "protocol": "x402",
        "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name",
        "payment_header_behavior": "Paid routes return HTTP 402 with PAYMENT-REQUIRED and machine-readable x402 accepts when no valid payment header is provided.",
        "safety_note": "The buyer client signs locally. Do not send wallet private keys to this API."
      },
      "advice_boundary": "Factual company profile context only; not legal advice, credit scoring, investment advice, supplier recommendation, or a risk clearance."
    },
    {
      "schema_version": "tw-procurement-ai-offer-v1",
      "product_id": "tw_procurement_supplier_signals",
      "title": "Taiwan Procurement & Supplier Signals API",
      "service_name": "Taiwan Supplier & Tender Intelligence",
      "buyer_summary": "Official-source Taiwan public procurement notices and awards packaged for market research, supplier activity discovery, tender monitoring, and AI-agent buyer workflows.",
      "primary_buyer_jobs": [
        "Find companies already active in Taiwan public-sector procurement.",
        "Identify incumbent suppliers and agencies around a Taiwan market segment.",
        "Validate whether a Taiwan supplier or sector is worth deeper paid research.",
        "Give AI assistants structured supplier candidates with lineage and limitations."
      ],
      "coverage_snapshot": {
        "notices_loaded": 32998,
        "awards_loaded": 26724,
        "total_loaded_rows": 59722,
        "earliest_loaded_record_date": "2017-05-23",
        "loaded_through_note": "Currently loaded Supabase rows from selected Public Construction Commission open-data files; not a full-market procurement registry.",
        "updated_at": "2026-07-08T00:00:00.000Z"
      },
      "source_trust": {
        "provider": "Public Construction Commission, Taiwan",
        "source_type": "official public open data",
        "source_language": "zh-Hant",
        "source_note": "Original Chinese source fields are preserved for audit use; English summaries are buyer-facing interpretations, not certified translations."
      },
      "language_strategy": {
        "source_language": "zh-Hant",
        "buyer_language": "en",
        "original_fields_preserved": true,
        "english_query_supported": true,
        "query_examples": [
          "IT services",
          "software",
          "AI",
          "construction",
          "medical",
          "education"
        ],
        "translation_note": "English summaries are template-based buyer-facing interpretations of structured source fields; they are not certified translations."
      },
      "free_validation": {
        "preview_url": "https://api.sourcestrand.com/v1/preview/tw-procurement/agent-research?q=IT%20services",
        "sample_url": "https://api.sourcestrand.com/samples/tw-procurement-supplier-signal.json",
        "expected_preview_shape": [
          "agent_summary",
          "supplier_candidates",
          "sample_records",
          "paid_unlock",
          "data_lineage",
          "limitations"
        ]
      },
      "paid_endpoints": [
        {
          "method": "GET",
          "url_template": "https://api.sourcestrand.com/v1/paid/tw-procurement/agent-research?q={keyword}",
          "price": "$0.01",
          "best_first_paid_step": true
        },
        {
          "method": "GET",
          "url_template": "https://api.sourcestrand.com/v1/paid/tw-procurement/tender-search?q={keyword}",
          "price": "$0.03"
        },
        {
          "method": "GET",
          "url_template": "https://api.sourcestrand.com/v1/paid/tw-procurement/company-activity?business_id={business_id}",
          "price": "$0.05"
        },
        {
          "method": "GET",
          "url_template": "https://api.sourcestrand.com/v1/paid/tw-procurement/supplier-pack?business_id={business_id}",
          "price": "$0.25"
        }
      ],
      "purchase_rationale": {
        "buyer_question": "Which companies, agencies, tenders, and incumbent suppliers show observable Taiwan public-sector procurement activity?",
        "why_pay_now": [
          "$0.01 is a low-friction paid validation step after the free preview.",
          "The paid agent package returns more rows and more supplier candidates than the free preview.",
          "Responses preserve official-source lineage, limitations, retrieval timestamps, and hashes for downstream audit.",
          "English buyer summaries and English query expansion reduce the translation burden for global market research workflows."
        ],
        "best_fit_buyers": [
          "International market research teams studying Taiwan public-sector demand.",
          "B2B sales teams looking for Taiwan accounts with observed government procurement activity.",
          "AI assistants that need structured supplier candidates, paid unlock metadata, and copy-ready handoff fields."
        ],
        "not_for": [
          "Supplier recommendations or procurement advice.",
          "Credit scoring, legal clearance, or investment advice.",
          "A complete guarantee that no other Taiwan public procurement activity exists."
        ],
        "paid_response_delta": {
          "preview_limit": 10,
          "preview_sample_records": 3,
          "preview_supplier_candidates": 3,
          "paid_agent_research_limit": 20,
          "paid_sample_records": 10,
          "paid_supplier_candidates": 10,
          "paid_adds": [
            "More matched tender and award rows for the same buyer query.",
            "More sample records for evidence review before deeper company activity or supplier-pack calls.",
            "More supplier candidate groups surfaced from award rows.",
            "agent_handoff metadata for buyer agents to preserve lineage, limitations, retrieved_at, and source_hash."
          ],
          "upgrade_path": [
            {
              "endpoint": "/v1/paid/tw-procurement/agent-research?q=",
              "price": "$0.01",
              "when_to_use": "First paid step after preview when an AI agent or analyst needs a structured research package."
            },
            {
              "endpoint": "/v1/paid/tw-procurement/tender-search?q=",
              "price": "$0.03",
              "when_to_use": "Use for broader keyword, agency, supplier, case name, or case number discovery."
            },
            {
              "endpoint": "/v1/paid/tw-procurement/company-activity?business_id=",
              "price": "$0.05",
              "when_to_use": "Use when a Taiwan business_id is available and the buyer wants company-level activity."
            },
            {
              "endpoint": "/v1/paid/tw-procurement/supplier-pack?business_id=",
              "price": "$0.25",
              "when_to_use": "Use after a target supplier is selected and a richer activity pack is worth requesting."
            }
          ]
        },
        "recommended_paid_call": {
          "endpoint": "/v1/paid/tw-procurement/agent-research?q=IT%20services",
          "price": "$0.01",
          "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name"
        }
      },
      "x402_purchase": {
        "protocol": "x402",
        "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name",
        "payment_header_behavior": "Paid routes return HTTP 402 with PAYMENT-REQUIRED and machine-readable x402 accepts when no valid payment header is provided.",
        "safety_note": "The buyer client signs locally. Do not send wallet private keys to this API."
      },
      "advice_boundary": "Factual public procurement discovery only; not procurement advice, supplier recommendation, legal advice, credit scoring, investment advice, or a risk clearance."
    },
    {
      "schema_version": "sourcestrand-product-offer-v1",
      "product_id": "crypto_agent_signals",
      "title": "Crypto Agent Signal Pack",
      "service_name": "Crypto Agent Signal Pack",
      "buyer_summary": "AI-agent-ready crypto and x402 signal snapshots with precomputed market context, liquidity, volatility, data quality, freshness, multi-window trends, evidence, and source-lineage fields.",
      "positioning": "This is not a raw price API. It packages small, low-cost, computed signal snapshots so humans and AI assistants can skip first-pass calculation, trend comparison, and context assembly.",
      "primary_buyer_jobs": [
        "Fetch mainstream BTC, ETH, SOL, SUI, or ADA context by symbol without needing a contract address.",
        "Fetch a compact token context snapshot when an agent has a chain and address.",
        "Fetch an x402 ecosystem brief for resource mix, payment context, and network distribution.",
        "Preserve not_financial_advice, data_lineage, limitations, generated_at, valid_until, and source_hash in downstream answers.",
        "Compare 30m, 1h, 4h, 6h, 8h, and 24h token trend windows without rebuilding a time-series pipeline."
      ],
      "free_validation": {
        "sample_url": "https://api.sourcestrand.com/samples/crypto-agent-signal-pack.json",
        "expected_sample_shape": [
          "mainstream_asset_signal",
          "token_risk_snapshot",
          "x402_ecosystem_brief",
          "not_financial_advice",
          "data_lineage",
          "limitations",
          "generated_at",
          "valid_until",
          "source_hash"
        ]
      },
      "paid_endpoints": [
        {
          "method": "GET",
          "url_template": "https://api.sourcestrand.com/v1/paid/crypto/asset-signal?asset={symbol}",
          "example_url": "https://api.sourcestrand.com/v1/paid/crypto/asset-signal?asset=BTC",
          "supported_assets": [
            "BTC",
            "ETH",
            "SOL",
            "SUI",
            "ADA"
          ],
          "price": "$0.01",
          "best_first_paid_step": true
        },
        {
          "method": "GET",
          "url_template": "https://api.sourcestrand.com/v1/paid/crypto/token-risk-snapshot?chain={chain}&address={address}",
          "example_url": "https://api.sourcestrand.com/v1/paid/crypto/token-risk-snapshot?chain=base&address=0x1111111111111111111111111111111111111111",
          "price": "$0.01",
          "best_when": "Use when the buyer or agent already has a Base token address."
        },
        {
          "method": "GET",
          "url_template": "https://api.sourcestrand.com/v1/paid/crypto/x402-ecosystem-brief",
          "example_url": "https://api.sourcestrand.com/v1/paid/crypto/x402-ecosystem-brief",
          "price": "$0.01",
          "best_when": "Use when the buyer wants x402 resource mix and payment-context signals."
        }
      ],
      "precomputed_signal_fields": [
        "buyer_signal_summary",
        "decision_support_metrics.overall_score",
        "decision_support_metrics.metric_cards",
        "decision_support_metrics.flags",
        "decision_support_metrics.answerability",
        "trend_indicators.windows",
        "trend_indicators.distance_to_average_bps",
        "trend_indicators.not_realtime",
        "agent_summary",
        "data_lineage",
        "limitations"
      ],
      "x402_purchase": {
        "protocol": "x402",
        "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name",
        "payment_header_behavior": "Paid routes return HTTP 402 with PAYMENT-REQUIRED and machine-readable x402 accepts when no valid payment header is provided.",
        "safety_note": "The buyer client signs locally. Do not send wallet private keys to this API."
      },
      "advice_boundary": "Informational signal pack only; not investment, legal, tax, accounting, allocation, or trading instruction.",
      "not_financial_advice": true
    }
  ],
  "product_detail_urls": {
    "tw_company_intelligence": "https://api.sourcestrand.com/data-products/tw-company.json",
    "tw_procurement_supplier_signals": "https://api.sourcestrand.com/data-products/tw-procurement.json",
    "crypto_agent_signals": "https://api.sourcestrand.com/data-products/crypto-agent-signals.json"
  },
  "x402_purchase": {
    "protocol": "x402",
    "expected_unpaid_status": 402,
    "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name",
    "safety_note": "The buyer client signs locally. Do not send wallet private keys to this API."
  }
}