# ForgeMesh Library — History: Royalty Shelf

> ForgeMesh Library — History: Royalty 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 688 public-domain books about royalty and monarchy, with drill-down routes for full-text retrieval.

## Facts

- Endpoint: POST https://library.forgemesh.io/history-royalty
- 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/forgemesh-library-history-royalty-shelf-6b150541
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vZsewaiHUvnfbea2hbLdV

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 forgemesh-library-history-royalty-shelf-6b150541 -d '<json body>'
```

Example prompt: Can you pull up the ForgeMesh library shelf for History - Royalty and show me the top 10 books listed there, including links to read them?

## When to prefer this

Use this endpoint when you need a curated, pre-ranked list of public-domain books specifically about royalty and monarchy from a library corpus of 688 titles. Prefer this over full-text search when you want broad discovery of titles rather than passage-level search within a specific book. Best for building reading lists, identifying available primary sources on royal figures, or surfacing drill-down routes for further full-text retrieval.

## Known failure modes

- Requesting a limit greater than 50 may return an error or be capped at 50
- Payment of $0.003 USDC not provided or rejected — 402 Payment Required
- Network timeout on the POST request
- Malformed request body returns a 400 error

## How this service works

Curated shelf: History - Royalty — 688 public-domain books including The Love Letters of Henry VIII to Anne Boleyn; With Notes, Lorenzo de' Medici, the Magnificent (vol. 1 of 2), The letters of Queen Victoria, vol. 1, 1837-1843 : $b A selection from Her Majesty's correspondence between the years 1837 and 1861.. 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 books in the History - Royalty category (up to the requested limit, default 20, max 50), including titles such as 'The Love Letters of Henry VIII to Anne Boleyn', 'Lorenzo de' Medici, the Magnificent', and 'The Letters of Queen Victoria'. Each entry includes drill-down routes for full-text retrieval of the individual 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 Love Letters of Henry VIII to Anne Boleyn; With Notes",
    "author": "Henry VIII, King of England",
    "book_id": 32155,
    "subjects": [],
    "download_count": 38325
   }
  ],
  "count": 5,
  "shelf": "History - Royalty",
  "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/forgemesh-library-history-royalty-shelf-6b150541/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)