# Node4All — Agent-first API gateway for the x402 payment economy.

> Node4All is an agent-first API infrastructure platform. We ship spec-compliant x402 v2 endpoints (EIP-3009 authorization + Coinbase CDP facilitator) so autonomous agents can discover, pay for, and consume APIs with a single off-chain signature — no API keys, no subscriptions, no human in the loop. Hosted at node4all.com with a sandbox (Base Sepolia) and production (Base Mainnet) environment.

You are viewing the sandbox (Base Sepolia testnet) environment.

## About Node4All

Node4All (https://node4all.com) is an agent-first API infrastructure platform focused on the x402 payment economy. Our mission: make api monetization machine-native so that any ai agent can transact with any api using the http 402 protocol.

Every Node4All API endpoint follows the same contract: HTTP 402 with standards-compliant x402 v2 headers, facilitated by the Coinbase CDP facilitator, priced in USDC on Base. No accounts, no API keys, no subscriptions — just a single off-chain signature per request.

## Environments

- **Production** (`api.node4all.com`) — Base Mainnet, real USDC. For production agent traffic.
- **Sandbox** (`sandbox.node4all.com`) — Base Sepolia, testnet USDC. For integration testing.
- **Apex** (`node4all.com`) — Marketing site + documentation + discovery index.

## Paid endpoints (x402 v2)

- **Node4All Fortune** — deterministic fortune reading (demo of the x402 v2 flow).
  - Production: `GET https://api.node4all.com/v1/coinbase/x402-test` — Base Mainnet, $0.001 USDC. Facilitator: Coinbase CDP.
  - Sandbox: `GET https://sandbox.node4all.com/v1/coinbase/x402-test` — Base Sepolia, testnet USDC. Facilitator: Coinbase CDP.
  - Public aliases `/v1/x402-test` on each subdomain 301-redirect to the canonical `/v1/coinbase/x402-test`.

## Payment flow (x402 v2)

1. Client `GET`s the endpoint with no payment → server responds `402` + a base64-encoded `PAYMENT-REQUIRED` header containing a JSON `PaymentRequired` object with one or more `accepts` entries.
2. Client decodes the header, picks an `accepts` entry, signs an EIP-3009 `transferWithAuthorization` for the listed amount + `payTo`.
3. Client retries with the encoded authorization in a `PAYMENT-SIGNATURE` header.
4. Coinbase CDP facilitator verifies the signature and settles the transfer on-chain.
5. Server returns `200` + a `PAYMENT-RESPONSE` header (settlement receipt) + the endpoint's JSON body.

## Tooling for agents

- **npm**: [`@node4all/x402-agent-toolkit`](https://www.npmjs.com/package/@node4all/x402-agent-toolkit) — MCP server giving Claude Desktop and other MCP-capable agents native access to Node4All x402 endpoints.
- **Postman**: Import the [Node4All x402 collection](https://node4all.com/postman/node4all-x402.postman_collection.json) for request/response scaffolding.
- **x402-fetch**: Any standards-compliant x402 v2 client works out of the box (e.g. the official `x402-fetch` npm package from Coinbase).

## Discovery endpoints

- Machine-readable catalogue: `/.well-known/x402.json`
- OpenAPI: `/openapi.json` (on each subdomain)
- Swagger UI: `/docs` (on each subdomain)
- Postman collection: `https://node4all.com/postman/node4all-x402.postman_collection.json`
- Agent identity card: `/.well-known/agent.json`
- Source: https://github.com/MadeCode/x402

## Links

- Website: https://node4all.com
- Blog: https://node4all.com/blog
- Contact: https://node4all.com/contact
- Terms of service: https://node4all.com/terms
- Privacy policy: https://node4all.com/privacy