Coffee Cup Reading API (moved)

This repository is archived. The maintained DivineAPI docs and examples for the Coffee Cup Reading API are in DivineAPI/tarot-api.

The old divineapi.com/api/1.0/...php URLs shown in earlier versions of this repo are not the current API. The current endpoint returns three coffee cup symbols (present, near future, distant future), each with a title, image URL and reading text.

Current endpoint

POST https://astroapi-5.divineapi.com/api/v2/coffee-cup-reading

Auth: your auth token as an Authorization: Bearer header and your API key as the api_key form field (never in the URL). lan sets the response language (default en).

curl -X POST "https://astroapi-5.divineapi.com/api/v2/coffee-cup-reading" \
  -H "Authorization: Bearer YOUR_AUTH_TOKEN" \
  -F "api_key=YOUR_API_KEY" \
  -F "lan=en"

Real response (2 Oct 2026, trimmed with ...):

{
  "success": 1,
  "data": {
    "prediction": {
      "present_title": "HAT",
      "present_image": "https://divineapi.com/public/api-assets/coffee_cup/55.png",
      "present_content": "There ought to be a balance that must be kept in various combat zones. ...",
      "near_future_title": "Letter",
      "near_future_image": "https://divineapi.com/public/api-assets/coffee_cup/64.png",
      "near_future_content": "The symbol of the letter signifies the deliverance of news. ...",
      "distant_future_title": "Cross",
      "distant_future_image": "https://divineapi.com/public/api-assets/coffee_cup/42.png",
      "distant_future_content": "You like assisting those around you in the same way as a boat is used to cross the unfamil..."
    }
  }
}

Links

• API reference: https://developers.divineapi.com/horoscope-and-tarot-api/coffee-cup-reading
• Maintained repo: https://github.com/DivineAPI/tarot-api
• Get an API key: start the 14-day free trial (credit card required to activate the trial) at https://divineapi.com/start-trial