>_Open x402 funding rail

Introduction

• Network: Base mainnet (eip155:8453) in production
• Fee: 0.25% of net, $0.001 min, $0.25 max · status payment_received means paid, not delivered — check forwardStatus
• Two modes: fund any EVM target, or provision a managed child + fund it
• Machine contracts: llms.txt, openapi.json

Who needs what

deposit.now is an agent / API rail. You do not connect a browser wallet on this site to use the product. Credentials differ by role:

Quickstart

1. Install an x402 client (e.g. @x402/fetch + viem for JS).
2. POST JSON — either { target, amount, memo? } or { provision: true, label, amount, memo? }
3. Handle 402 — pay gross (amount + 0.25%, min $0.001, max $0.25) in USDC. Provision mode includes child.address.
4. Retry with the same body + payment proof; read receiptId / receiptUrl from the 200 body.

Bare-bones flow

1. 1. Agent calls POST /api/deposit with either { target: "0x…", amount: "50.00" } or { provision: true, label: "child-1", amount: "50.00" }
2. 2. Server returns 402 + x402 payment request for 0.25% fee (min $0.001, max $0.25) (and child when provisioned).
3. 3. Agent pays full gross via x402 to the platform Coinbase Agentic (CDP) wallet.
4. 4. Backend confirms settlement → keeps fee → forwards net to target (or the managed child) via CDP.
5. 5. Returns payment_received + receiptUrl. Check the receipt for forwardStatus and Basescan links — 200 does not mean the target already holds funds.

Endpoints

Code examples

import { wrapFetchWithPayment } from '@x402/fetch';
import { x402Client } from '@x402/core/client';
import { ExactEvmScheme } from '@x402/evm/exact/client';
import { privateKeyToAccount } from 'viem/accounts';

const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY); // payer agent only
const client = new x402Client();
client.register('eip155:*', new ExactEvmScheme(signer));
const fetchWithPayment = wrapFetchWithPayment(fetch, client);

const res = await fetchWithPayment('https://deposit.now/api/deposit', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    provision: true,
    label: 'trading-agent-1',
    amount: '50.00',
    memo: 'Fund child trading agent',
  }),
});
console.log(await res.json());

curl -i -X POST https://deposit.now/api/deposit \
  -H 'Content-Type: application/json' \
  -d '{"provision":true,"label":"trading-agent-1","amount":"50.00","memo":"Fund child trading agent"}'
# → HTTP 402 + Payment-Required (pay 0.25%, max $0.25); includes child.address

Security

• Platform hot wallet via Coinbase CDP / Agentic Wallet only — no raw platform private keys in app code.
• Managed children are platform_managed in CDP — API never returns private keys.
• Strict validation: EVM address + amount caps (0.01–100000 USDC); provision rate limits.
• Rate limiting on /api/* (stricter on deposit and provision).
• x402 facilitator verifies payment on-chain before success response.
• Forward to target only after settlement; retries + settlement logs on failure.

FAQ