# FluxA Monetize

> One endpoint to discover external API tools, LLM models, and skills and pay for them per call over x402 (HTTP 402). Payment is settled by the FluxA Wallet CLI.

API tools cover web, news, academic, and social search; research, sentiment, and trending / hot-topic monitoring; stock, finance, crypto, and market data, signals, and prediction markets; scraping and crawling Twitter/X, Reddit, YouTube, and websites; and image and video generation. Callable LLM model endpoints include DeepSeek, GLM, Minimax, GPT, Claude, and Gemini.

## Start here

- [Agent skill (fluxa-monetize)](https://monetize-qa.fluxapay.xyz/skill.md): the self-updating skill file. Discovery-first; how to find tools and pay for calls.
- [Discovery gateway](https://monetize-qa.fluxapay.xyz/api/discover): one endpoint listing APIs, skills, and models. Reference below.

## Install the skill

Install the FluxA agent-wallet skill so it triggers automatically on future tasks (paid APIs, LLM access, wallet ops, publishing):

```bash
npx skills add -s fluxa-agent-wallet -y -g FluxA-Agent-Payment/FluxA-AI-Wallet-MCP
```

## Query the discovery gateway

`GET https://monetize-qa.fluxapay.xyz/api/discover` — one endpoint for every tool on the platform. Returns JSON by default; send `Accept: text/markdown` for a human-readable catalog. Results are tagged `source`: `fluxa` (verified, proxied) or `bazaar` (curated external x402).

Two lookup modes over the same catalog: **`search`** for fuzzy discovery, **`query`** for an exact known slug/tag/provider. Send neither to browse (paginated).

| Param | Values | Behavior |
|-------|--------|----------|
| `type` | `api`, `skill`, `model` (comma-separated) | What to list. Default `api`. Unknown values return 400. |
| `search` (alias `q`) | keywords | Fuzzy: every whitespace term must appear in name/description/tags/slug. Scans the whole catalog and includes `bazaar`. Refine with more keywords if the first try misses. |
| `query` | one slug, tag, or provider | Exact, case-insensitive equality. `fluxa` results only (no `bazaar`). Use when you already know the identifier. |
| `tags` | comma-separated tags | Restrict to items carrying any of these tags. |
| `limit` | integer, default `50`, max `1000` | Page size when browsing. Ignored while `search`/`query` is set (those scan the full catalog). |
| `offset` | integer, default `0` | Page cursor when browsing. Follow `pagination.nextOffset` for the next page. Ignored while filtering. |

Examples:

```bash
# fuzzy search for an API (JSON)
curl "https://monetize-qa.fluxapay.xyz/api/discover?type=api&search=weather forecast"

# readable catalog instead of JSON
curl -H "Accept: text/markdown" "https://monetize-qa.fluxapay.xyz/api/discover?type=api"

# exact lookup by known slug, plus skills, in one call
curl "https://monetize-qa.fluxapay.xyz/api/discover?type=api,skill&query=acme-weather"

# LLM model catalog with per-token Units rates
curl "https://monetize-qa.fluxapay.xyz/api/discover?type=model"

# browse page two
curl "https://monetize-qa.fluxapay.xyz/api/discover?type=api&limit=50&offset=50"
```

JSON response shape: `apiServers[]`, `skills[]`, and (when `type` includes `model`) `models[]`, plus a `pagination` object (`offset`, `limit`, `returned`, `total`, `nextOffset`). Each API item carries `urls.access` (the proxy URL to call) and `urls.integrationGuide`; each skill carries an `install` command and `urls.details`.

## Call an LLM model

Models are grouped by merchant (provider). List them with `GET https://monetize-qa.fluxapay.xyz/api/discover?type=model`. Each entry carries `provider`, `id`, `displayName`, `categories`, `inputUnitsPer1M`, and `outputUnitsPer1M` (Units per 1M tokens; 1 Unit = $0.00001, so 100,000 Units = $1). Available families include DeepSeek, GLM, Minimax, GPT, Claude, and Gemini.

Call a model over the OpenAI Chat Completions wire format:

`POST https://backend-payment-proxy-servers-qa.up.railway.app/llm/{merchant}/chat/completions`

| Field | Value |
|-------|-------|
| Auth | `Authorization: Bearer <fxa_live_api_key>` (human key) or `Authorization: Bearer <agent_vc_token>` (agent). One key works across every model of that merchant. |
| Body | `{"model": "<model_id>", "messages": [...]}`. `stream: true` is supported. |
| Billing | Charged in Units against a prepaid, per-merchant balance. Rates are the `inputUnitsPer1M`/`outputUnitsPer1M` from the model listing. |
| Top up | `POST https://backend-payment-proxy-servers-qa.up.railway.app/llm/topup/initiate`, or buy a bundle on the merchant page. |

```bash
# list models with per-token Units rates
curl "https://monetize-qa.fluxapay.xyz/api/discover?type=model"

# call a model (OpenAI chat.completions wire format)
curl https://backend-payment-proxy-servers-qa.up.railway.app/llm/{merchant}/chat/completions \
  -H "Authorization: Bearer $FLUXA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<model_id>","messages":[{"role":"user","content":"Hello"}]}'
```

Per-merchant model details: `https://monetize-qa.fluxapay.xyz/marketplace/models/{merchant}/skills.md`. Credentials, per-merchant Units balances, and topups: `https://monetize-qa.fluxapay.xyz/api/llm/skills.md`.

## Discover

- [Merchants](https://monetize-qa.fluxapay.xyz/marketplace/merchants): every creator publishing monetized APIs and skills.
- [Models catalog](https://monetize-qa.fluxapay.xyz/api/discover?type=model): LLM endpoints and per-token Units rates.
- [Per-API payment guide](https://monetize-qa.fluxapay.xyz/marketplace/apis/skills.md): the x402 payment walkthrough that applies to every API.

## Build and sell

- [Units wallet guide](https://monetize-qa.fluxapay.xyz/api/llm/skills.md): prepaid per-merchant Units balances, credentials, and topups.
- [Publish an API](https://monetize-qa.fluxapay.xyz/console/apis/skills.md): turn your API into a paid x402 endpoint.
- [Create a skill](https://monetize-qa.fluxapay.xyz/create-skill.md): package a routine and publish it for agents to install.