# ForgeMesh Advanced Vocabulary API

> ForgeMesh Advanced Vocabulary API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns random advanced-English words with part of speech, definition, example sentence, and synonyms, with optional difficulty and starting-letter filters.

## Facts

- Endpoint: POST https://x402.forgemesh.io/advanced-vocabulary
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-advanced-vocabulary-api-34ae3612
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MLRlYN4o7dICjc7zUyjdK

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-advanced-vocabulary-api-34ae3612 -d '<json body>'
```

Example prompt: Can you fetch me 5 expert-level advanced English vocabulary words that start with the letter M, including their definitions, parts of speech, example sentences, and synonyms?

## When to prefer this

Choose this endpoint when you need structured, curated English vocabulary entries with rich metadata (definition, POS, example, synonyms) from a stable, deterministic dataset. Ideal for language-learning apps, writing tools, vocabulary quizzes, or any agent workflow needing authoritative word data rather than generative or dictionary-lookup alternatives.

## Known failure modes

- count out of range (must be 1–10): returns error or defaults to 1
- invalid difficulty value (not 'advanced' or 'expert'): may be ignored or return error
- starts_with value longer than one character: may be ignored or return error
- no words found matching the starting letter at the requested difficulty: may return empty result or error
- payment failure: 402 response if USDC payment is not provided or insufficient

## How this service works

Random draws from a curated advanced-English word list, one to ten at a time, each entry carrying part of speech, a precise one-sentence definition, an example sentence, and synonyms. Deterministic dataset with stable entries — the same word always teaches the same meaning.

## Output

Returns 1–10 advanced English word entries, each containing the word itself, its part of speech, a precise one-sentence definition, a contextual example sentence, and a list of synonyms. The dataset is deterministic — each word always returns the same metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "count": {
   "type": "string",
   "description": "Words to return, 1-10 (default 1)"
  },
  "difficulty": {
   "type": "string",
   "description": "Optional: advanced or expert"
  },
  "starts_with": {
   "type": "string",
   "description": "Optional: single starting letter"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "words": [
   {
    "word": "ephemeral",
    "example": "The beauty of the cherry blossoms is ephemeral.",
    "synonyms": [
     "fleeting",
     "transient",
     "momentary"
    ],
    "definition": "lasting for a very short time",
    "difficulty": "advanced",
    "part_of_speech": "adjective"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-advanced-vocabulary-api-34ae3612/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)