---
name: fluxa-monetize
description: 'Discover and pay for external APIs, LLM models, and skills an agent can call on demand, and publish your own for agents to pay for. Payment runs through the FluxA Wallet CLI over x402 (HTTP 402); the agent never writes payment code. TRIGGER: the task needs an external API the user has no key for (web search, scraping, social/Twitter data, image/video generation, crypto data, flights, email verification, and more); the user wants LLM access without provider accounts (OpenAI-compatible, prepaid Units); the user wants to publish or sell an API, skill, or model to agents; or any mention of FluxA, monetize.fluxapay.xyz, x402, Units, Monetize Credits. SKIP: the user already has a working key for the needed service, or named a different payment rail.'
homepage: https://monetize.fluxapay.xyz
---

# FluxA Monetize

One discovery gateway plus a payment layer: find APIs, LLM models, and skills at a single endpoint and pay per call over x402. The platform handles all payment mechanics. **Never write x402 or payment code.**

## Discovery: start here

Everything begins at one endpoint. Curl it to find a tool for the task:

```bash
curl "https://monetize.fluxapay.xyz/api/discover?type=api,skill,model"
```

- Fuzzy search: `?search=<keywords>` (matches name, description, tags).
- Exact lookup: `?query=<slug|tag|provider>`.
- Filter by kind: `?type=api`, `?type=skill`, `?type=model` (comma-separate to combine).
- Each result carries `source: fluxa` (verified) or `source: bazaar` (curated external x402). Verified are listed first.

To use a result, call its endpoint. The first unpaid call returns HTTP 402; the FluxA Wallet CLI settles it and the retry returns your data. You never write payment code.

Found a skill you want? Install it directly:

```bash
npx -y skills add https://monetize.fluxapay.xyz -s <slug>
```

## This File Updates Itself

The canonical copy of this file is hosted. Re-fetch it anytime to pick up new endpoints, flows, and fixes:

```bash
curl https://monetize.fluxapay.xyz/skill.md
```

## Ephemeral Sandbox Warning (Claude Web / Desktop / Cowork)

`fluxa-wallet init` creates wallet state on the machine where it runs. In sandboxed environments (Claude Web, Claude Desktop, Claude Cowork) the sandbox may be reset at any time and the wallet lost. **Do not run wallet setup inside a sandbox.** Instead, give the user the exact commands to run in a terminal on their own machine:

```bash
npm install -g @fluxa-pay/fluxa-wallet
fluxa-wallet init --name "<AGENT_NAME>" --client "<CLIENT>"
```

This does not apply to Claude Code, Cursor, Codex, or other agents running directly on the user's machine.

## Pay for a Call (x402)

One-time setup, then paid calls settle themselves:

```bash
npm install -g @fluxa-pay/fluxa-wallet
fluxa-wallet init --name "<AGENT_NAME>" --client "<CLIENT>"   # see sandbox warning above
```

- `planner plan "<task>"` — recommends the APIs / models / skills for a task, with an estimated budget. It recommends only; you run the calls.
- `planner search "<q>"` · `planner models` — discover tools and model rates. `search` matches the slug, so a known slug resolves directly.
- `planner balance` · `planner topup <merchant>` · `planner keys` — manage prepaid Units and API keys.
- `planner info` — a self-contained explainer (no network, no auth).

**To make a paid call**, hit the endpoint; on an HTTP 402, settle it with `fluxa-wallet` (sign a mandate once, then retry with the `X-Payment` token). The `X-Agent-ID` header is optional (attribution only). The full flow is in the payment guide below.

A convenience layer over the same endpoints: it turns a task into a set of tools and runs paid calls for you, delegating payment to the wallet CLI so it never holds keys. The discovery API and wallet above are the primitive; the planner is optional.

```bash
npm install -g @fluxa-pay/planner @fluxa-pay/fluxa-wallet
planner plan "<task>"                  # recommends tools for a task
planner call <slug>                    # prints the endpoint's input schema
planner call <slug> --data '<json>'    # makes the paid call, settles from your wallet
```

`planner search` and `planner models` discover tools; `planner balance`, `planner topup <merchant>`, and `planner keys` manage prepaid Units and API keys; `planner info` is a self-contained explainer.

## Hot Facts

| Fact | Value |
|------|-------|
| Platform (docs, discovery) | https://monetize.fluxapay.xyz |
| Proxy (API calls, wallet ops) | https://proxy-monetize.fluxapay.xyz |
| Units | 1 Unit = $0.00001; 100,000 Units = $1 = 1 Monetize Credit (MC) |

| Credential | Used for |
|-----------|----------|
| `X-Agent-ID` header (from `fluxa-wallet status`) | optional attribution on API calls; required only for `require_agent_auth` configs + MCP `tools/call` |
| `Authorization: Bearer fxa_live_<key>` | LLM endpoints + Units wallet (user creates at https://monetize.fluxapay.xyz/keys) |
| `Authorization: Bearer <agent_vc>` | LLM endpoints + Units wallet, for FluxA Wallet agents |

## Flows

| Intent | Start here | Done when |
|--------|-----------|-----------|
| Call a paid API | Have the slug? `curl https://proxy-monetize.fluxapay.xyz/api/<slug>` (schema) → call the endpoint; settle the HTTP 402 with `fluxa-wallet`. No slug? `planner search "<keywords>"` or `curl "https://monetize.fluxapay.xyz/api/discover?type=api&q=<keywords>"` first, then `curl https://monetize.fluxapay.xyz/marketplace/apis/skills.md` (read once). | the paid call returns 200 with data |
| Use LLMs in an app | `curl https://monetize.fluxapay.xyz/api/llm/skills.md` (wallet + credentials), then the merchant's page from `curl "https://monetize.fluxapay.xyz/api/discover?type=model"` for the OpenAI SDK drop-in | SDK call succeeds; cost visible in `X-LLM-Cost-Credits` |
| Publish & monetize an API | `curl https://monetize.fluxapay.xyz/console/apis/skills.md` | `curl https://proxy-monetize.fluxapay.xyz/api/<your-slug>` returns your endpoints; a test paid call settles |
| Create & publish a skill | `curl https://monetize.fluxapay.xyz/create-skill.md` | your skill appears in `curl "https://monetize.fluxapay.xyz/api/discover?type=skill"` |

## Hard Rules

- **Confirm every topup or spend plan with the user before initiating it.** Present costs first; get an explicit choice. Each charge must be a known, deliberate spend.
- **Never write payment code.** No x402 signing, no mandate logic in app code. Agents use the wallet CLI; apps use API keys.
- **Report costs honestly.** Surface `X-LLM-Cost-Credits` after LLM calls; a negative balance is unsettled debt (`pendingSettlement`). Say so plainly.

## Common Pitfalls

- A **503** from wallet endpoints means the auth service is briefly down. Retry shortly. Do not mint a new Agent VC.
- A **failed topup order is dead**: retrying its finalize returns 409, so create a new topup instead.
- **Streaming LLM responses carry no cost headers**; they are metered after the stream closes.
- The creator UID path segment on proxy URLs (`https://proxy-monetize.fluxapay.xyz/api/<slug>/<uid>`) is **optional referral attribution**. Drop it if you do not have one.
- **Sandbox-created wallets lose funds** (see warning above).

## Support

- Discover everything: `curl https://monetize.fluxapay.xyz/api/discover`
- All merchants: `curl -H "Accept: text/markdown" https://monetize.fluxapay.xyz/marketplace/merchants`
- Homepage: https://monetize.fluxapay.xyz