# penny402 Agent Horoscope

> penny402 Agent Horoscope is a paid API for AI agents from penny402.fun, paid per call via x402, $0.0025/call, status unknown (last checked 2026-09-16).

Returns a daily horoscope written for AI agents — stable per wallet per UTC day, drawn from a pre-generated pool keyed to the paying address.

## Facts

- Endpoint: POST https://penny402.fun/horoscope
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/penny402-agent-horoscope-556c0377
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yJTUYdnzAZIEcO5awbI-9

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 penny402-agent-horoscope-556c0377 -d '<json body>'
```

Example prompt: Can you fetch today's horoscope for my agent wallet? I just want the daily reading — I know it'll be the same if I ask again today.

## When to prefer this

Choose this endpoint when you want a deterministic, wallet-keyed, agent-culture-themed daily horoscope that is cheap ($0.0025 USDC), fast (pre-generated pool, no model inference at request time), and stable for the day. Prefer it over generative text endpoints when you need idempotent repeated reads within the same UTC day, or when the agent-specific thematic content (retries, context windows, schema drift) is the desired flavor rather than a generic star-sign horoscope.

## Known failure modes

- Payment not received or wallet has insufficient USDC — returns HTTP 402 with payment terms
- Rate or pool exhaustion — pool may be finite for the day
- Malformed POST body — endpoint expects an empty JSON object {}
- Network timeout — though fast since no model runs at request time
- Stale UTC day boundary edge cases if client clock differs from server UTC

## How this service works

One horoscope per paying wallet per UTC day, drawn from that day's pool and keyed to the address that paid: ask twice today and the reading is identical, ask tomorrow and it is a new one. Written for agents rather than star signs — retries and backoff, stale caches, context windows, schema drift, the comment that stopped being true. It predicts no outcome and stakes nothing. Served from a pre-generated pool: one round trip, no model running while you wait.

## Output

A short horoscope text written for AI agents rather than star signs, touching on themes like retries, backoff strategies, stale caches, context windows, schema drift, and misleading comments. The reading is deterministic for the calling wallet and the current UTC day — repeated calls return the same text; the next UTC day yields a new one. Served from a pre-generated pool with no model inference at request time.

## 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",
     "description": "a JSON body, up to 4 KB. This attraction takes no parameters — POST {} . Every attraction on penny402 is a flat $0.0025; the unpaid 402 carries those exact terms."
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "POST"
    },
    "bodyType": {
     "type": "string",
     "const": "json"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "format"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "text"
    },
    "format": {
     "type": "string",
     "const": "application/json",
     "description": "the attraction, as JSON, in the response body"
    },
    "example": {
     "description": "a sample response from the real code path"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/penny402-agent-horoscope-556c0377/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from penny402.fun](https://www.zero.xyz/host/penny402.fun/llms.txt)
