# Coinbase Onramp URL Generator

> Coinbase Onramp URL Generator is a paid API for AI agents from agent402.tools, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Generates a single-use Coinbase Onramp checkout URL that lets a user fund a wallet with USDC (or other crypto) via card or Apple Pay, including a fee-inclusive quote.

## Facts

- Endpoint: POST https://agent402.tools/api/onramp-link
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coinbase-onramp-url-generator-8f0d90d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lRj708lloO_xg6KEQKkE1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability coinbase-onramp-url-generator-8f0d90d8 -d '<json body>'
```

Example prompt: Generate a Coinbase Onramp checkout link to send 25 USDC to my Base wallet at 0xAbc123...def456 — I'm in the US, state NY, and redirect me to https://myapp.com/success after checkout.

## When to prefer this

Use this endpoint when you need to let a human fund an on-chain wallet with fiat currency (card or Apple Pay) via Coinbase Onramp, especially when the destination is a Base, Ethereum, Polygon, Arbitrum, Optimism, or Solana wallet. Prefer this over manual exchange instructions when you want a single frictionless checkout link with a fee-inclusive quote.

## Known failure modes

- Invalid or malformed wallet address returns a 400-level error
- Unsupported network name causes a validation error
- Country not supported by Coinbase Onramp returns an error
- Amount below minimum or above maximum threshold causes rejection
- Missing required address field returns a validation error
- x402 payment of $0.001 USDC fails if agent wallet is underfunded

## How this service works

Generate a single-use Coinbase Onramp URL that lets a human fund any wallet with a card or Apple Pay - the fastest way to put real USDC into an agent's wallet. Returns the ready-to-open URL, and a fee-inclusive quote when Coinbase provides one. Networks: base, ethereum, polygon, arbitrum, optimism, solana.

## Output

Returns a ready-to-open single-use Coinbase Onramp URL the user can click to complete purchase via card or Apple Pay, along with a fee-inclusive quote showing the total cost for the requested crypto amount.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "asset": {
   "type": "string",
   "description": "Ticker to purchase (default USDC)"
  },
  "amount": {
   "type": "string",
   "description": "Crypto amount the wallet should receive (default 10)"
  },
  "address": {
   "type": "string",
   "description": "Destination wallet address (EVM 0x… or Solana base58, matching the network)"
  },
  "country": {
   "type": "string",
   "description": "Buyer's ISO 3166-1 country code (default US)"
  },
  "network": {
   "type": "string",
   "description": "base (default) | ethereum | polygon | arbitrum | optimism | solana"
  },
  "redirectUrl": {
   "type": "string",
   "description": "Optional URL to send the buyer to after checkout"
  },
  "subdivision": {
   "type": "string",
   "description": "US state code (e.g. NY) - required for US buyers by some payment methods"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Open the URL in a browser to complete the purchase - it is single-use and expires after first visit.",
  "onrampUrl": "https://pay.coinbase.com/…single-use…",
  "singleUse": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coinbase-onramp-url-generator-8f0d90d8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)