{"uid":"cap_vWJlGhSiPiNfRbBjK0wrT","slug":"x402-tools-vercel-app-c4f79303","name":"x402-tools Horoscope API","description":"Get a daily horoscope for any zodiac sign. Optionally request a specific date.","url":"https://x402-tools.vercel.app/api/horoscope","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["sign"],"properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format, or 'today'. Defaults to today."},"sign":{"type":"string","description":"Zodiac sign (aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","data"],"properties":{"data":{"type":"string","description":"The horoscope reading text"},"success":{"type":"boolean"}}}}}}},"responseSchema":{"type":"json","example":{"data":"You may feel a surge of creative energy today...","success":true}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"sign":"leo"}}},"response":{"data":"Volatile emotions may come to the surface among the members of your household today. This could prove irritating for you, Leo, but try to avoid becoming involved in others' quarrels. At times like this, a lot could be said that shouldn't be said, and apologies won't necessarily wipe it out. This is a great day to get some work done around the house, as your physical energy is high. Make use of your good aesthetic sense.","success":true}},"exampleRequest":{"sign":"leo"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_z-oyxj0EF7SJnAdoZF1IU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a daily horoscope reading for a specified zodiac sign, optionally for a given date.","exampleAgentPrompt":"What's the horoscope for Scorpio today? And also pull up the reading for Aries on 2025-07-15.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a boolean success flag and a text string containing the horoscope reading for the requested zodiac sign and date.","failureModes":["Missing required 'sign' query parameter — returns validation error","Invalid zodiac sign value — may return error or empty result","Invalid date format (not YYYY-MM-DD or 'today') — may fail or default to today","Payment not provided or insufficient — returns 402 Payment Required","Service unavailable or upstream horoscope data source down — returns 5xx error"],"whenToPreferThis":"Use this endpoint when a user asks for a horoscope or daily astrological reading for a specific zodiac sign. It supports any of the 12 standard zodiac signs and allows optional date specification, making it ideal for date-specific or 'today' horoscope lookups. Prefer this over scraping astrology websites or using generic LLM-generated horoscopes when you need a structured, paid API response with a specific daily reading.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:41:01.911Z","isFirstParty":false}