# ioswarm.io Horoscope Reading

> ioswarm.io Horoscope Reading is a paid API for AI agents from ioswarm.io, paid per call via x402, $0.5/call, status unknown (last checked 2026-10-28).

Generates a server-computed horoscope reading for the current sky positions, returned asynchronously via a poll URL within 3–10 minutes.

## Facts

- Endpoint: POST https://ioswarm.io/api/v1/x402/run/horoscope?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ioswarm-io-horoscope-reading-9531986d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6tzYIIc_8IZ2Im8I1eUe8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ioswarm-io-horoscope-reading-9531986d -d '<json body>'
```

Example prompt: Can you get me a horoscope reading for right now based on today's sky? My question is: 'What energy should I focus on this week for career growth?'

## When to prefer this

Choose this endpoint when you need a server-computed, real-time horoscope based on actual current sky positions rather than static or pre-written daily content. It requires no account — just a paying wallet — and is ideal for agents that need pay-per-use astrological content without managing subscriptions. Best for async workflows where a 3–10 minute delivery window is acceptable.

## Known failure modes

- Invalid or missing input text — request rejected before run is created
- Payment not received or insufficient USDC — run not started
- Poll URL returns pending status if checked before the 3–10 minute window
- Report generation timeout if server-side computation fails
- Malformed request body (wrong bodyType or method) — schema validation error

## How this service works

The sky right now, computed server-side, read for the caller. Pay $0.50 USDC per run; the response carries a run id and poll URL, the report lands in 3–10 minutes. No account needed — the paying wallet becomes the account and an API key is returned once.

## Output

A run ID and poll URL returned immediately; within 3–10 minutes, the poll URL resolves to a full horoscope reading computed from current sky positions, along with astrological interpretations relevant to the submitted question or brief. On first use, an API key is also returned tied to the paying wallet.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "input"
     ],
     "properties": {
      "input": {
       "type": "string",
       "description": "The question or brief."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "horoscope",
  "paid": {
   "usd": 0.5,
   "transaction": "0x…"
  },
  "run_id": "run-1789440847776-0001",
  "status": "running",
  "poll_url": "https://ioswarm.io/api/v1/runs/run-1789440847776-0001",
  "report_url": "https://ioswarm.io/api/v1/runs/run-1789440847776-0001/report"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ioswarm-io-horoscope-reading-9531986d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ioswarm.io](https://www.zero.xyz/host/ioswarm.io/llms.txt)