Playful Fortune Teller

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 POST \
  "https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/fortune_teller?preview=true" \
  --header "content-type: application/json" \
  --data '{"focus":"creativity","seed":"today-1"}'

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,
  "product": "fortune_teller",
  "source": "DopamineDesk original symbolic-reading templates v1",
  "seed": "example",
  "focus": "creativity",
  "reading_type": "entertainment_only",
  "symbols": [
    {
      "position": "Notice",
      "symbol": "Garden",
      "meaning": "Small repeated attention can nurture a good idea.",
      "prompt": "What would benefit from ten quiet minutes?"
    },
    {
      "position": "Explore",
      "symbol": "Kite",
      "meaning": "Leave room for a playful experiment.",
      "prompt": "What could you try without needing to get it perfect?"
    },
    {
      "position": "Carry forward",
      "symbol": "Drum",
      "meaning": "Find a rhythm you can enjoy keeping.",
      "prompt": "Which routine could become a small celebration?"
    }
  ],
  "playful_number": 21,
  "closing": "For your creativity reading, let garden be a prompt for curiosity today.",
  "caveat": "A fictional symbolic reading for fun and reflection, not a prediction or professional advice. No supernatural knowledge or personal information is used."
}

Why this offer exists

Three fictional symbols with reflection prompts and a playful number.

Buyer searches: fortune teller, fun fortune, symbol reading, playful prediction, reflection prompts.

Why pay: A structured entertainment reading; no personal data, model dependency or real prediction claim.

Launch price: 0.005 USDC per complete paid result. The live contract proof verifies source, freshness, inputs, and response shape before a wallet is asked to pay.

Purchase decision

Buy when: the active task needs this product's structured result, its declared source and freshness are sufficient, and 0.005 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": "computed_service",
    "billable": true,
    "availability": "operational",
    "source": "DopamineDesk original symbolic-reading templates v1"
  }
}

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.