# ForgemeshLibrary Fantasy Literature Shelf

> ForgemeshLibrary Fantasy Literature Shelf is a paid API for AI agents from library.forgemesh.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Returns a ranked list of up to 137 public-domain fantasy books with drill-down routes for full-text retrieval

## Facts

- Endpoint: POST https://library.forgemesh.io/fantasy-literature
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemeshlibrary-fantasy-literature-shelf-5de82f83
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C940lP9XmhMDFSWVvWfOQ

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 forgemeshlibrary-fantasy-literature-shelf-5de82f83 -d '<json body>'
```

Example prompt: Show me the top 30 public-domain fantasy books from the ForgemeshLibrary curated shelf so I can pick one to read.

## When to prefer this

Choose this endpoint when you need a curated, pre-ranked list of public-domain fantasy literature and want structured drill-down routes for full-text access. Prefer it over a full-text search endpoint when you want to browse the fantasy category broadly rather than search for specific passages or titles. Useful when building reading lists, recommendation engines, or literary research tools focused on classic fantasy.

## Known failure modes

- Limit parameter exceeds 50 — likely returns an error or caps at 50
- Limit set to 0 or negative — may return empty list or validation error
- Service temporarily unavailable — HTTP 5xx response
- Payment failure or insufficient USDC balance — 402 Payment Required before content is returned

## How this service works

Curated shelf: Fantasy literature — 137 public-domain books including The Wonderful Wizard of Oz, Peter Pan : $b [Peter and Wendy], The Wonderful Wizard of Oz. Returns a ranked list with drill-down routes for full-text retrieval. No license, no API key required.

## Output

A ranked list of public-domain fantasy book titles (up to the requested limit, default 20, max 50) including entries like The Wonderful Wizard of Oz and Peter Pan, along with drill-down routes that can be used to retrieve the full text of each book.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max books to return (default 20, max 50)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "books": [
   {
    "year": null,
    "title": "The Wonderful Wizard of Oz",
    "author": "Baum, L. Frank (Lyman Frank)",
    "book_id": 55,
    "subjects": [],
    "download_count": 34120
   }
  ],
  "count": 5,
  "shelf": "Fantasy literature",
  "coverage": {
   "target": 61015,
   "indexed": 61015
  },
  "drill_down": [
   "/book-metadata",
   "/book-chapter",
   "/book-quotes",
   "/literature-search"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemeshlibrary-fantasy-literature-shelf-5de82f83/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from library.forgemesh.io](https://www.zero.xyz/host/library.forgemesh.io/llms.txt)