AgentMarket
FluxA AgentMarket is the marketplace for paid APIs, models, Token Plans and skills that agents can buy with the FluxA Wallet. fluxa-wallet market … searches it and manages model spending.
market commands and plan-tool-use print formatted text meant for people and agents to read, not JSON.
Authentication is automatic: the CLI uses your Agent ID. To use an AgentMarket API key instead, set FLUXA_KEY=fxa_live_….
Discover
fluxa-wallet market info # all market commands
fluxa-wallet market info units # topics: overview, units, auth, pay, keys, models, tokenplan, skills
fluxa-wallet market search "twitter sentiment"
fluxa-wallet market search --models # models and their Units price
fluxa-wallet market search --vendors # model providers
fluxa-wallet plan-tool-use "summarise today's AI news with sources"| Command | Description |
|---|---|
market info [topic] | Built-in guide. No login needed |
market search "<query>" | Find APIs, models and skills. --models or --vendors narrows the search |
plan-tool-use "<task>" | Recommends the models, APIs and skills for a task, with how to call them |
Paid APIs are called with x402: see Mandates & x402 payments.
Models and Units
Model calls (OpenAI-compatible) are paid from one prepaid Units balance shared across all providers. 1 Unit = $0.00001, so 100,000 Units = $1.
| Command | Description |
|---|---|
market model remainingUsage | Current Units balance. A negative balance is usage not yet paid for |
market model usageHistory | Spending and top-up history |
market model topup | Buy Units |
market model topup
fluxa-wallet market model topup # starter bundle, Monetize Credits, user approves
fluxa-wallet market model topup --bundle mid --usdc # pay in Base USDC
fluxa-wallet market model topup --bundle starter --mandate mand_xxx # reuse a signed mandate, no new approval| Flag | Default | Description |
|---|---|---|
--bundle | starter | Bundle to buy: mini ($1, 100,000 Units), starter ($5), mid ($10), pro ($25). Units are sold only in bundles |
--credit | ✓ | Pay with Monetize Credits |
--usdc | — | Pay with Base USDC. Can't be combined with --credit |
--mandate | — | Reuse a signed mandate (and its currency). If it is invalid, expired or too small, the command fails rather than creating a new one |
--budget | enough for the bundle | Budget of the new mandate, atomic units. Not with --mandate |
--seconds | 28800 | Validity of the new mandate. Not with --mandate |
Without --mandate, the command creates a mandate and prints its approval link. It then waits while the user approves it in the wallet.
API keys
fxa_live_ keys let other programs call AgentMarket models on your account. They require the Agent ID login, not another key.
fluxa-wallet market keys # list
fluxa-wallet market keys create --name ci --cap 5000000 # $50 cap
fluxa-wallet market keys update <id> --cap 0 # 0 removes the cap
fluxa-wallet market keys revoke <id>--cap sets a spend cap for the key. The service counts the cap in Units (100,000 Units = $1), even though the CLI help text says credits. For example, --cap 5000000 caps the key at $50. The full key is shown once, when it is created. Store it as a secret.
Token Plans
A Token Plan is a flat monthly model allowance used on the provider's own endpoint, with the provider's key. It is an alternative to Units for steady, predictable usage. A plan key only works at the provider, and an fxa_live_ key only works at AgentMarket.
| Command | Description |
|---|---|
market tokenplan list | Plans held: allowance left, days left, plan ID |
market tokenplan key <id> | The provider key and base URL for a plan |
market tokenplan usage <id> | What the plan has spent, per model |
market tokenplan models | Models a plan can call |
market tokenplan buy <plan> | Creates a USDC checkout link for lite, standard or advanced. Nothing is charged until the user opens it and approves |
market tokenplan order <id> | Whether a purchase has been paid and the plan is ready |
market tokenplan redeem <code> --yes | Redeem a personal redemption code |
market tokenplan claim <code> --yes | Claim a shared plan code |
Codes are one-time
redeem and claim use up the code and can't be undone. Confirm with the user before running them; --yes is required. For security, every invalid code (used, expired or unknown) returns the same message.