# MyRadar weather API pricing per request: Credits and monthly plans

MyRadar's weather API bills every call as one request at your plan's rate, whichever service it calls: $0.02 per 100 requests on Credits with no monthly fee, or a lower rate on the Starter ($199 a month), Pro ($399 a month) and Platinum ($549 a month) monthly plans. Buy a plan once with `POST https://agents.myradar.dev/zcj/zj375myw4zhh/plans/{planId}/purchase` and a bearer credential, the agent identity the storefront issues, then send each call with `Authorization: Bearer <token>`. Only the purchase answers with a 402, the price quote, which you pay over x402, MPP or card and retry.

## At a glance

- **One meter:** every call to forecast, severe weather, road weather time series or radar and weather layers is one request, billed at your plan's rate.
- **Credits:** $0.02 per 100 requests, no monthly fee. Buy from $0.02 on a wallet rail or $0.50 by card, and top up with `POST https://agents.myradar.dev/zcj/zj375myw4zhh/extend`.
- **Monthly plans:** Starter $199 a month with $199 of included credit, Pro $399 a month with $399, Platinum $549 a month with $550. Usage beyond the included credit is metered at the plan's rate.
- **Buy:** `POST https://agents.myradar.dev/zcj/zj375myw4zhh/plans/{planId}/purchase` with your bearer. Each plan's `purchase.url` in the manifest gives the exact path.
- **Payment:** x402 and MPP settle in USDC on Base and Tempo; card settles in USD.
- **Check what you hold:** `GET https://agents.myradar.dev/zcj/zj375myw4zhh/agent/entitlements` with your bearer returns each plan with its status, period and `remainingCreditUsd`.
- **Live prices:** [manifest.json](https://agents.myradar.dev/zcj/zj375myw4zhh/manifest.json). Read it at call time.
- **Full purchase flow:** [the buyer skill](https://agents.myradar.dev/zcj/zj375myw4zhh/SKILL.md)

## Rate per request by service and plan

The plan sets the rate. The service does not change it.

| Service | Credits | Starter | Pro | Platinum |
| --- | --- | --- | --- | --- |
| Forecast | $0.02 per 100 requests | $0.199 per thousand requests | $0.133 per thousand requests | $0.11 per thousand requests |
| Severe weather | $0.02 per 100 requests | $0.199 per thousand requests | $0.133 per thousand requests | $0.11 per thousand requests |
| Road weather time series | $0.02 per 100 requests | $0.199 per thousand requests | $0.133 per thousand requests | $0.11 per thousand requests |
| Radar and weather layers | $0.02 per 100 requests | $0.199 per thousand requests | $0.133 per thousand requests | $0.11 per thousand requests |

One call is one request, whatever it returns. A time series call with a list of points counts as one request. Each map tile is its own call, so it counts as one request.

## Plans and what they include

| Plan | Fee | Included credit | Purchase body | Verified email |
| --- | --- | --- | --- | --- |
| Credits | None | None | `{"amountUsd": "<amount in whole cents>"}`: at least $0.02 on a wallet rail or $0.50 by card | - |
| Starter | $199 a month | $199 | No amount. The fee is charged. | Requested: shared at purchase if your credential is claimed, or when you claim it |
| Pro | $399 a month | $399 | No amount. The fee is charged. | Requested: shared at purchase if your credential is claimed, or when you claim it |
| Platinum | $549 a month | $550 | No amount. The fee is charged. | Requested: shared at purchase if your credential is claimed, or when you claim it |

Each plan covers all four services. Credits draw down a prepaid balance at the Credits rate. On a monthly plan, the fee includes credit that covers usage at the plan's rate. Usage beyond that credit is billed on top of the fee at the same rate.

## Monthly usage at stated volumes

The table gives usage at each plan's rate only: the request count times the rate. It does not include a monthly plan's fee. The figures use the forecast rate. Every service has the same rate on a plan, so they hold for any mix of services.

| Requests in a month | Credits | Starter | Pro | Platinum |
| --- | --- | --- | --- | --- |
| 100,000 | $20 | $19.90 | $13.30 | $11 |
| 500,000 | $100 | $99.50 | $66.50 | $55 |
| 2,000,000 | $400 | $398 | $266 | $220 |
| 4,000,000 | $800 | $796 | $532 | $440 |
| 10,000,000 | $2000 | $1990 | $1330 | $1100 |

On Credits, the month costs the usage figure. On a monthly plan, usage draws on the included credit, and usage beyond it is metered at the plan's rate on top of the fee.

## What one request draws

An example forecast call on Credits:

```bash
curl -sS -i "https://agents.myradar.dev/zcj/zj375myw4zhh/v1/forecast/38.8977,-77.0365?units=us" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

This request drew $0.0002 from Credits, one request at $0.02 per 100 requests. The response is a JSON object with `latitude`, `longitude`, `timezone`, `currently`, `minutely`, `hourly`, `daily` and `flags`. Its `zc-billing` header reports what the call drew, in this shape:

```
zc-billing: {"status":"settled","fundingSource":"credit","chargedUsd":"<amount drawn>","remainingCreditUsd":"<balance after the call>"}
```

`fundingSource` is `credit` for Credits and `subscription` for a monthly plan.

## Buying, topping up and checking a plan

| Action | Request | Notes |
| --- | --- | --- |
| Buy a plan | `POST https://agents.myradar.dev/zcj/zj375myw4zhh/plans/{planId}/purchase` | Send your bearer. The answer is one priced 402 to pay. |
| Top up Credits | `POST https://agents.myradar.dev/zcj/zj375myw4zhh/extend` with `{"amountUsd": "<amount in whole cents>"}` | Same bearer, same one-402 payment. The new balance returns as `access.remainingCreditUsd`. |
| Check holdings | `GET https://agents.myradar.dev/zcj/zj375myw4zhh/agent/entitlements` | Returns active plans with plan, status, period and `remainingCreditUsd`. Check it before buying again. |

| Rail | Settles in | Where the bearer goes |
| --- | --- | --- |
| x402 | USDC on Base | `Authorization: Bearer <token>` |
| MPP | USDC on Tempo | `ZC-Agent-Authorization: Bearer <token>`, because `Authorization` carries the payment |
| Card | USD | `Authorization: Bearer <token>`. Send `"checkout": true` for a hosted checkout URL a person can pay. Credits by card start at $0.50. |

Register a bearer credential at [auth.md](https://agents.myradar.dev/zcj/zj375myw4zhh/auth.md). The [buyer skill](https://agents.myradar.dev/zcj/zj375myw4zhh/SKILL.md) has every purchase step.

## Pricing and purchase errors

| Code | Meaning | Action |
| --- | --- | --- |
| `401 bearer_required` | The call or purchase carried no agent credential | Register, then retry with your bearer |
| `403 plan_required` | Your credential holds no plan covering the call | Buy a plan from the body's `plans` list, each with its `purchase.url`, then retry |
| `usage_exhausted` | The credit balance ran out | Top up with `/extend` or purchase again |
| `amount_required` | A Credits purchase carried no `amountUsd` | Add a whole-cent `amountUsd` |
| `amount_below_minimum` / `amount_not_cent_increment` | The amount is under $0.02 or not whole cents | Send whole cents at or above the minimum |
| `amount_below_card_minimum` | A new card purchase is under the card minimum | Send at least $0.50, or pay on a wallet rail |
| `plan_not_extendable` | The plan does not take credit top-ups | Use that plan's purchase contract instead |

[MyRadar API errors and recovery](/guides/errors) covers the rest.

## What is charged when

- Reading the manifest, services and API reference is free and needs no credential. Registering a credential is free.
- Paying the purchase's 402 completes the purchase and accepts the [platform buyer terms](https://www.zeroclick.ai/legal/buyer-terms-of-service).
- Calls never answer with a 402. A call without a plan is refused with `401` or `403` and draws nothing.
- On Credits, each call draws one request at the Credits rate. On a monthly plan, the fee is charged at purchase and usage beyond the included credit is metered at the plan's rate.
- An anonymous credential that nobody claims lapses within a few days, taking any plan bought with it. Claim it to a verified email before or soon after buying.

## Frequently asked questions

### How much does one MyRadar API request cost?

One request costs $0.02 per 100 requests, $0.199 per thousand requests, $0.133 per thousand requests or $0.11 per thousand requests. The rate is the same for forecast, severe weather, road weather time series and radar and weather layers.

### What do 1,000 requests cost?

1,000 requests cost $0.20 on Credits, $0.199 at the Starter rate, $0.133 at the Pro rate and $0.11 at the Platinum rate. On a monthly plan, that usage draws on the included credit first.

### Can I pay per call without buying a plan?

No. Every call draws on a plan bought with a bearer credential, and a bare call returns `401 bearer_required`. The smallest Credits purchase is $0.02 on a wallet rail.

### Do monthly plans charge for usage beyond the fee?

Yes, beyond the included credit. Starter includes $199, Pro $399 and Platinum $550. Usage past that credit is billed at the plan's rate on top of the fee.

### How do I check which plan I already hold?

Send `GET https://agents.myradar.dev/zcj/zj375myw4zhh/agent/entitlements` with your bearer. It lists your active plans here with status, period and `remainingCreditUsd`. An empty list shows no active plan, but it does not rule out a pending purchase, so reconcile before buying again.

## Keep reading

- [Get a weather forecast by latitude and longitude](/guides/quickstart)
- [MyRadar API errors and recovery](/guides/errors)
- [The buyer skill](https://agents.myradar.dev/zcj/zj375myw4zhh/SKILL.md): the full purchase flow
- [How to pay](https://agents.myradar.dev/zcj/zj375myw4zhh/payment.md): rails, plans and top-ups
- [manifest.json](https://agents.myradar.dev/zcj/zj375myw4zhh/manifest.json): live plans and prices

---

Updated 2026-10-20. All MyRadar guides: https://agents.myradar.dev/guides.md. Storefront: https://agents.myradar.dev/zcj/zj375myw4zhh/llms.txt.
