--- name: api.node4all.com description: api.node4all.com exposes three x402 payment-gated endpoints on Base mainnet: two novelty fortune/motivational message generators and one Markdown-to-PDF conversion service. All endpoints require per-request USDC micropayments via the x402 protocol. host: api.node4all.com --- # api.node4all.com Node4All is a small utility host offering two categories of functionality: novelty fortune payloads (motivational text, lucky number, lucky color, energy theme) and document conversion (Markdown to PDF). It serves agents that need lightweight, pay-per-request utility calls on Base mainnet without subscription overhead. The fortune endpoints differ mainly in input requirements—one requires an EIP-3009 payment signature, the other accepts no inputs beyond the x402 payment header. ## When to use this host Use this host when an agent needs a quick novelty fortune or motivational payload on Base mainnet and is set up to pay via x402 USDC micropayments. Prefer fetch-fortune-message over fetch-node4all-fortune when no EIP-3009 signature is available, as it requires no inputs. Use convert-markdown-to-pdf when an agent needs to render Markdown to PDF for up to 10MB files at $0.02 per conversion. Do not use this host for real financial data, price feeds, HTML or DOCX conversion, large file processing (over 10MB), or any chain other than Base mainnet (eip155:8453). For structured document conversion beyond Markdown, use a dedicated document conversion API. ## Capabilities ### Fortune and Motivational Messages Returns novelty fortune payloads including a text message, lucky number, lucky color, and energy theme. Two variants are available: one requiring an explicit EIP-3009 payment signature and one that is input-free beyond the x402 payment header. - **`fetch-node4all-fortune`** — Returns a fortune string, lucky number, lucky color, and energy theme from Node4All via an x402-v2 USDC-gated endpoint on Base mainnet. - **`fetch-fortune-message`** — Returns a fortune-style JSON payload containing a motivational message, lucky number, lucky color, and energy status via x402-v2 on Base mainnet. ### Document Conversion Converts UTF-8 Markdown content—supplied as a JSON string or a multipart .md file upload up to 10MB—into a binary PDF document, returned as application/pdf. - **`convert-markdown-to-pdf`** — Converts a UTF-8 Markdown string or .md file upload into a PDF document, returned as binary application/pdf content, via an x402 payment-gated endpoint costing $0.02 USDC on Base. ## Skill reference ### `fetch-node4all-fortune` **Node4All Fortune API** — Returns a fortune string, lucky number, lucky color, and energy theme from Node4All via an x402-v2 USDC-gated endpoint on Base mainnet. *Use when:* Use when an agent needs a deterministic fortune payload (fortune text, lucky number, lucky color, energy theme) and is prepared to sign and submit an EIP-3009 USDC payment authorization on Base mainnet. *Not for:* Do not use for real-time price feeds, financial data, or any structured information beyond a novelty fortune payload. Not suitable for chains other than Base mainnet (eip155:8453). **Inputs:** - `PAYMENT-SIGNATURE` (string, required) — Base64-encoded EIP-3009 transferWithAuthorization signature over USDC on Base mainnet, submitted as an HTTP request header. Required to pass the x402-v2 paywall (2000 USDC atomic units = $0.002). **Returns:** Returns a JSON object with status, service/network metadata, and a fortune payload containing fortune text, lucky_number, lucky_color, and energy theme. **Example:** `GET https://api.node4all.com/v1/x402-test Headers: { "PAYMENT-SIGNATURE": "" }` --- ### `convert-markdown-to-pdf` **Markdown to PDF** — Converts a UTF-8 Markdown string or .md file upload into a PDF document, returned as binary application/pdf content, via an x402 payment-gated endpoint costing $0.02 USDC on Base. *Use when:* Use when an agent needs to render Markdown content (including bold, italic, links, code, emoji, and accented characters) into a downloadable PDF binary. Accepts either a JSON body with a markdown string or a multipart .md file upload up to 10MB. *Not for:* Do not use for converting HTML, DOCX, or other non-Markdown formats to PDF; use a dedicated document conversion API instead. Not suitable for files larger than 10MB. **Inputs:** - `markdown` (string, required) — UTF-8 Markdown source content to convert to PDF. Used in application/json request body. Mutually exclusive with multipart file upload. - `file` (string, required) — Markdown file (.md) uploaded as multipart/form-data binary field, up to 10MB. Mutually exclusive with JSON markdown field. **Returns:** Returns a binary application/pdf body containing the rendered PDF document, with a PAYMENT-RESPONSE header carrying the x402 settlement receipt. **Example:** `{"markdown": "# Hello\n\nThis is **bold**."}` --- ### `fetch-fortune-message` **Node4All Fortune API** — Returns a fortune-style JSON payload containing a motivational message, lucky number, lucky color, and energy status via x402-v2 on Base mainnet. *Use when:* Use when an agent needs a lightweight, single-shot fortune or motivational message with associated lucky attributes (number, color, energy) and wants to pay per-request via x402 on Base mainnet. *Not for:* Do not use for real-time price feeds, financial data, or any structured information beyond a fortune message and its associated lucky attributes. **Returns:** Returns a JSON object with status, service metadata, protocol/network info, and fortune fields: a motivational message string, a lucky number integer, a lucky color string, and an energy string. **Example:** `GET https://api.node4all.com/v1/coinbase/x402-test` ---