# NOWNodes

> Blockchain JSON-RPC and explorer API for Ethereum, Base, Solana, and Bitcoin. Called through Service Router at https://pay-servicerouter.agents.bakingbad.dev/service/nownodes, paid per call.

Full-node access through NOWNodes, paid per call.

JSON-RPC: send one JSON-RPC 2.0 request per HTTP call, as you would to any node.
- POST /eth   Ethereum mainnet (eth_blockNumber, eth_getBalance, eth_call, ...)
- POST /base  Base mainnet
- POST /sol   Solana mainnet (getSlot, getBalance, ...)

Explorer (Blockbook REST) for Bitcoin mainnet: addresses, transactions, blocks,
UTXOs, and fee estimates. Add `details=basic` to address calls to keep responses small.

## Routes

| Route | What it does | Price | Pay with |
|---|---|---|---|
| `POST /eth` | Ethereum JSON-RPC | $0.0005 | credits (payment key), x402, MPP |
| `POST /base` | Base JSON-RPC | $0.0005 | credits (payment key), x402, MPP |
| `POST /sol` | Solana JSON-RPC | $0.0005 | credits (payment key), x402, MPP |
| `GET /btc/api/v2/address/{address}` | Balance and transactions of a Bitcoin address | $0.001 | credits (payment key), x402, MPP |
| `GET /btc/api/v2/tx/{txid}` | A Bitcoin transaction | $0.001 | credits (payment key), x402, MPP |
| `GET /btc/api/v2/block/{block}` | A Bitcoin block by height or hash | $0.001 | credits (payment key), x402, MPP |
| `GET /btc/api/v2/utxo/{descriptor}` | Unspent outputs of an address or xpub | $0.001 | credits (payment key), x402, MPP |
| `GET /btc/api/v2/estimatefee/{blocks}` | Fee estimate for confirmation within N blocks | $0.001 | credits (payment key), x402, MPP |

## How to pay

1. **Credits (default).** Send a Service Router payment key as `Authorization: Bearer sr_live_…`. A paid answer carries `Servicerouter-Receipt`. The guide at https://servicerouter.agents.bakingbad.dev/llms.txt shows how to get an account and a key, with the user's consent.
2. **x402.** Without a key, the `402` answer carries `PAYMENT-REQUIRED` with x402 options. Sign one and retry with `PAYMENT-SIGNATURE`.
3. **MPP.** The same `402` carries `WWW-Authenticate: Payment` with a Tempo charge. Retry with `Authorization: Payment …`.

Only billable answers are charged: a failed call costs nothing.

## Call it

```sh
curl -X POST "https://pay-servicerouter.agents.bakingbad.dev/service/nownodes/eth" \
  -H "Authorization: Bearer $SERVICEROUTER_PAYMENT_KEY" \
  -H "Content-Type: application/json" -d '{…}'
```

## Documents

- [OpenAPI](https://api-servicerouter.agents.bakingbad.dev/v1/services/nownodes/openapi.json): every route, with its price in `x-payment-info`. Its server is the pay URL.
- [Agent Skill](https://api-servicerouter.agents.bakingbad.dev/v1/services/nownodes/skill.md)
- [Service Router guide](https://servicerouter.agents.bakingbad.dev/llms.txt)