--- name: api.x402.jobs description: api.x402.jobs is a paid API host on the x402 protocol that exposes a small set of demo and novelty endpoints: random cat facts (from two sources), a random cat image, a random Hunter x Hunter image, and a test job submission endpoint. All calls are paid per-request in USDC on Base (eip155:8453). host: api.x402.jobs --- # api.x402.jobs api.x402.jobs serves as a demonstration and novelty host on the x402 paid-API protocol. It offers two cat fact sources, a cat image endpoint, an anime image endpoint, and a workflow test endpoint. Its primary utility is for developers testing x402 payment flows or building lightweight content-enrichment features around cat or anime imagery. ## When to use this host Use api.x402.jobs when an agent needs lightweight novelty content (cat facts or cat/anime images) delivered inline as base64 data URLs, or when a developer needs to verify an x402 paid POST workflow end-to-end. Do not use this host for production data processing, bulk retrieval, or any content outside cats and Hunter x Hunter anime. For non-cat animal facts, seek a general animal facts API. For anime images beyond Hunter x Hunter, this host has no filtering or series-selection capability. The test endpoint (post-x402-test-job) is strictly for workflow validation and should not be used in production pipelines. All endpoints cost USDC per call on Base, so looping calls without cost accounting will accumulate charges quickly. ## Capabilities ### Cat Facts Retrieves a single random cat fact per call from one of two independent sources (KittyFact or MeowFacts), returning the fact text and its character length alongside payment receipt data. - **`fetch-cat-fact`** — Returns a single random cat fact as JSON from a paid proxy endpoint on Base (eip155:8453), costing 0.01 USDC per call. - **`fetch-random-cat-fact`** — Returns a single random cat fact as a JSON string with its character length, sourced from the MeowFacts dataset via a paid GET endpoint. ### Cat Imagery Returns a single random cat image as a base64-encoded JPEG data URL, suitable for inline display or embedding in responses. - **`fetch-random-cat-picture`** — Returns a single random cat image as a base64-encoded JPEG data URL in a JSON response, one image per request. ### Anime Imagery Returns a random Hunter x Hunter character or scene image as a base64-encoded WebP data URL, one image per paid request. - **`fetch-hunterxhunter-pic`** — Returns a random Hunter x Hunter image as a base64-encoded WebP data URL from a paid x402 endpoint. ### x402 Workflow Testing Submits a paid POST to a test job endpoint and returns a job ID, status polling URL, and payment confirmation, enabling end-to-end verification of x402 payment and job-queuing flows. - **`post-x402-test-job`** — Submits a paid JSON POST to the x402.jobs test endpoint and returns a queued job receipt with a job ID, status URL, and payment confirmation. ## Workflows ### Cat Fact + Image Bundle *Use when an agent needs to present a cat fact alongside a cat image in a single response, such as for a cat-of-the-day feature or enriched content card.* 1. **`fetch-cat-fact`** — Retrieve a random cat fact and its character length to use as the text component of the response. 2. **`fetch-random-cat-picture`** — Retrieve a random cat image as a base64 JPEG data URL to pair with the fact for display. ## Skill reference ### `post-x402-test-job` **x402 Test Endpoint** — Submits a paid JSON POST to the x402.jobs test endpoint and returns a queued job receipt with a job ID, status URL, and payment confirmation. *Use when:* Use when an agent needs to verify that a paid x402.jobs POST workflow is functioning end-to-end, receiving a job ID and status polling URL in return. *Not for:* Do not use for production job submissions or data processing; this is a test endpoint only. Not suitable for retrieving job results — poll the returned statusUrl separately. **Returns:** Returns a job receipt with a UUID jobId, a statusUrl for polling, a retryAfterSeconds hint, and a receipt object confirming the on-chain USDC payment transaction hash. **Example:** `{"test": true, "input": {"message": "Hello x402.jobs — running a paid JSON POST test request.", "requestId": "x402-test-8453-2026-05-17T00:00:00Z"}}` --- ### `fetch-hunterxhunter-pic` **Hunter x Hunter Pic** — Returns a random Hunter x Hunter image as a base64-encoded WebP data URL from a paid x402 endpoint. *Use when:* Use when an agent or user needs a Hunter x Hunter character or scene image and can accept a base64 WebP data URL as the response. *Not for:* Do not use for other anime series images or for retrieving images by specific character or episode; no filtering parameters are supported. **Returns:** Returns a JSON object with a single field imageDataUrl containing a base64-encoded WebP image as a data URL. **Example:** `POST https://api.x402.jobs/@ebitbank/hunterxhunter-pic` --- ### `fetch-cat-fact` **KittyFact API** — Returns a single random cat fact as JSON from a paid proxy endpoint on Base (eip155:8453), costing 0.01 USDC per call. *Use when:* Use when an agent needs a random cat fact to display, enrich content, or answer a user question about cats; the call costs 0.01 USDC and returns immediately. *Not for:* Do not use for bulk cat fact retrieval or streaming fact feeds; this endpoint returns exactly one fact per paid request. **Returns:** Returns a JSON object with a single cat fact string, its character length, and a payment receipt containing the transaction hash and USDC amount paid. **Example:** `GET https://api.x402.jobs/@rawgroundbeef/a-cat-fact` --- ### `fetch-random-cat-picture` **Random Cat Picture** — Returns a single random cat image as a base64-encoded JPEG data URL in a JSON response, one image per request. *Use when:* Use when an agent or user needs a random cat image to display, embed, or process, and requires the full image data inline rather than a remote URL. *Not for:* Do not use for bulk or batch image retrieval; this endpoint returns exactly one image per paid request. Not suitable for streaming or real-time cat image feeds. **Returns:** Returns a JSON object with a single 'imageDataUrl' field containing a base64-encoded JPEG data URL of a random cat image (~206KB). **Example:** `GET https://api.x402.jobs/@rawgroundbeef/random-cat-picture` --- ### `fetch-random-cat-fact` **MeowFacts Random Cat Fact** — Returns a single random cat fact as a JSON string with its character length, sourced from the MeowFacts dataset via a paid GET endpoint. *Use when:* Use when the agent needs to retrieve a random cat fact to display, share, or incorporate into cat-related content or trivia responses. *Not for:* Do not use for bulk or repeated cat fact retrieval in a loop without accounting for per-call cost of 0.01 USDC; not suitable for non-cat animal facts. **Returns:** Returns a JSON object with a random cat fact string, its character length, and an x402 payment receipt containing the transaction hash and USDC amount paid. **Example:** `GET https://api.x402.jobs/@rawgroundbeef/random-cat-fact` ---