# fly.ai Pay-Per-Request Token API

> fly.ai Pay-Per-Request Token API is a paid API for AI agents from flyai-x402.fly.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-12).

Returns AI-generated answers for a given address/token via a pay-per-request x402 micropayment model at $0.03 USDC per call

## Facts

- Endpoint: POST https://flyai-x402.fly.dev/token/%7Baddr%7D?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fly-ai-pay-per-request-token-api-08d6c994
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ID_7H4SEaYGfX8zT6OH2C

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fly-ai-pay-per-request-token-api-08d6c994 -d '<json body>'
```

Example prompt: Ask fly.ai a question about the current DeFi yield rates using my wallet address 0xAbC123... and pay the 3-cent USDC fee per request via x402.

## When to prefer this

Choose this endpoint when you need single, one-off AI-generated answers without committing to a subscription, and when you are operating in a context where x402 micropayment support is available. Ideal for agents that need occasional AI lookups billed per-use in USDC, or for developers testing pay-per-request AI economics on-chain.

## Known failure modes

- Payment not authorized — x402 payment header missing or invalid, returns 402 Payment Required
- Insufficient USDC balance — wallet lacks funds, transaction rejected
- Invalid or malformed address parameter in URL path — returns 400 Bad Request
- Network or provider downtime on fly.dev infrastructure — returns 5xx error
- Rate limiting or abuse detection — request rejected without charge

## How this service works

Single answers, each paid on its own over x402. Guide: https://www.flyaiworld.com/x402-api.md

## Output

A single AI-generated text answer returned after successful x402 micropayment authorization; the agent receives the answer payload in the response body after the $0.03 USDC charge is processed.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fly-ai-pay-per-request-token-api-08d6c994/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from flyai-x402.fly.dev](https://www.zero.xyz/host/flyai-x402.fly.dev/llms.txt)
