# FluxA AgentMarket

[FluxA AgentMarket](https://agentmarket.fluxapay.xyz) is a marketplace of paid APIs for AI agents. It lists Tomba and forwards requests to 20 Tomba endpoints through its router. FluxA builds, prices, and supports this integration: you authenticate with a FluxA API key or the FluxA Wallet and pay FluxA, and the requests don't use your Tomba credits. The listing is [agentmarket.fluxapay.xyz/marketplace/apis/tomba](https://agentmarket.fluxapay.xyz/marketplace/apis/tomba).

## Prerequisites

- A FluxA API key, created at [agentmarket.fluxapay.xyz/keys](https://agentmarket.fluxapay.xyz/keys). Calls made with the key are paid from your AgentMarket balance.
- Or, to pay per call in USDC on Base instead: the FluxA Wallet CLI (`npm install -g @fluxa-pay/fluxa-wallet`), connected to your FluxA wallet with `fluxa-wallet connect --client "My agent"`.

You don't need a Tomba account. Setup, billing, and support questions go to FluxA.

## Connect an agent

The listing publishes a skill file with every endpoint, its parameters and price, and the payment steps: [agentmarket.fluxapay.xyz/marketplace/apis/tomba/skills.md](https://agentmarket.fluxapay.xyz/marketplace/apis/tomba/skills.md). Give that URL to Claude Code, Codex, or another agent that can make HTTP requests, then ask it to find or verify an email. Without the FluxA Wallet, the agent asks you for a FluxA API key before its first call.

## Call Tomba with a FluxA API key

Send requests to `https://router.fluxapay.xyz/api/tomba` followed by the Tomba path without `/v1`, with the key as a bearer token. The parameters are Tomba's, so the [API reference](/api) applies.

<CodeTabs syncKey="lang">

```bash title="cURL"
curl "https://router.fluxapay.xyz/api/tomba/email-finder?domain=stripe.com&first_name=Jane&last_name=Doe" \
    -H "Authorization: Bearer $FLUXA_API_KEY"
```

```js title="Node.js"
const response = await fetch(
    "https://router.fluxapay.xyz/api/tomba/email-finder?domain=stripe.com&first_name=Jane&last_name=Doe",
    { headers: { Authorization: `Bearer ${process.env.FLUXA_API_KEY}` } },
);
console.log(await response.json());
```

</CodeTabs>

The `X-Balance-Charge` response header gives what the call cost and the balance left. `GET https://router.fluxapay.xyz/api/tomba` lists the endpoints with FluxA's current price for each.

<Callout type="caution">
    A FluxA API key spends your AgentMarket balance. Load it from an environment
    variable or a secrets manager, never from source code.
</Callout>

## Endpoints

| Method | Path                  | Reference                                                            |
| ------ | --------------------- | -------------------------------------------------------------------- |
| `GET`  | `/domain-search`      | [Domain search](/api/finder#domain-search)                           |
| `GET`  | `/email-finder`       | [Email finder](/api/finder#email-finder)                             |
| `GET`  | `/email-verifier`     | [Email verifier](/api/verifier#email-verifier)                       |
| `GET`  | `/author-finder`      | [Author finder](/api/finder#author-finder)                           |
| `GET`  | `/linkedin`           | [LinkedIn finder](/api/finder#linkedin-finder)                       |
| `GET`  | `/phone-finder`       | [Phone finder](/api/phone#phone-finder)                              |
| `GET`  | `/phone-validator`    | [Phone validator](/api/phone#phone-validator)                        |
| `GET`  | `/email-count`        | [Email count](/api/finder#email-count)                               |
| `GET`  | `/email-sources`      | [Email sources](/api/email#email-sources)                            |
| `GET`  | `/email-format`       | [Email format](/api/finder#email-format)                             |
| `GET`  | `/enrich`             | [Email enrichment](/api/finder#email-enrichment)                     |
| `GET`  | `/people/find`        | [Person enrichment](/api/enrichment#person-api)                      |
| `GET`  | `/companies/find`     | [Company enrichment](/api/enrichment#company-api)                    |
| `GET`  | `/combined/find`      | [Combined enrichment](/api/enrichment#combined-api)                  |
| `GET`  | `/technology`         | [Technology](/api/domain#technology)                                 |
| `GET`  | `/location`           | [Location](/api/finder#location)                                     |
| `GET`  | `/similar`            | [Similar domains](/api/domain#similar)                               |
| `GET`  | `/domain-suggestions` | [Domain suggestions](/api/domain-suggestions#get-domain-suggestions) |
| `GET`  | `/domain-status`      | [Domain status](/api/domain#domain-status)                           |
| `POST` | `/reveal/search`      | [Company search](/api/reveal#search-companies)                       |

## Pay per call with x402

Without a key, the router answers a paid endpoint with `402 Payment Required` and an x402 `accepts` array priced in USDC on Base. The FluxA Wallet pays it within a spending mandate you approve once. With the CLI connected (see Prerequisites) and `jq` installed:

```bash
URL="https://router.fluxapay.xyz/api/tomba/email-verifier?email=jane.doe@stripe.com"

# A budget of 1 USDC (amounts are in USDC atomic units), valid for 7 days.
# Open the printed link and approve the budget before the wait ends.
MANDATE=$(fluxa-wallet mandate-create --desc "Tomba lookups" --amount 1000000 --seconds 604800 --currency USDC)
echo "$MANDATE" | jq -r .data.authorizationUrl
MANDATE_ID=$(echo "$MANDATE" | jq -r .data.mandateId)
fluxa-wallet mandate-status --id "$MANDATE_ID" --wait 300

# Pay the 402 response, then repeat the request with the payment.
PAYMENT=$(fluxa-wallet x402-v3 --mandate "$MANDATE_ID" --payload "$(curl -s "$URL")" | jq -r .data.xPaymentB64)
curl "$URL" -H "X-Payment: $PAYMENT"
```

Reuse the mandate for later calls until its budget or time runs out. FluxA's [x402 payment guide](https://agentmarket.fluxapay.xyz/marketplace/apis/skills.md) covers mandates, agent IDs, and payment errors.

## Troubleshooting

| Response                          | Cause                                         | Fix                                                                                    |
| --------------------------------- | --------------------------------------------- | -------------------------------------------------------------------------------------- |
| `402` with an `accepts` array     | The request has no FluxA API key or payment   | Send `Authorization: Bearer` with your key, or pay with the FluxA Wallet               |
| `402` with `insufficient_balance` | Your AgentMarket balance can't cover the call | Top up at [agentmarket.fluxapay.xyz/console](https://agentmarket.fluxapay.xyz/console) |

To pay Tomba per request directly, without a Tomba account or a gateway, see [Agent payments (MPP)](/mpp/introduction).
