# Flipr-x402 Referral Payout

> Flipr-x402 Referral Payout is a paid API for AI agents from flipr-x402.fly.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Processes a referral payout on the Flipr on-chain coin flip game, disbursing earned referral rewards via the x402 payment protocol on Base.

## Facts

- Endpoint: POST https://flipr-x402.fly.dev/x402/referral/payout
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/flipr-x402-referral-payout-3bd544de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oofLjzkEQo-wDs8_A9YDx

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 flipr-x402-referral-payout-3bd544de -d '<json body>'
```

Example prompt: Claim my Flipr referral payout and send it to my wallet 0xABC123 — my agent ID is my-bot-v1 and I want all my earned referral commissions disbursed now.

## When to prefer this

Use this endpoint when an agent has accumulated referral rewards on the Flipr coin flip platform and needs to trigger an on-chain payout. Prefer this over the flip or analysis endpoints when the goal is to collect referral commissions rather than play the game or analyze opportunities.

## Known failure modes

- No referral earnings available to disburse — returns empty or zero payout
- Invalid or unrecognized agentId — payout cannot be attributed
- x402 payment of $0.001 USDC not received or insufficient — request rejected
- Blockchain congestion causing delayed transaction confirmation
- Invalid toAddress format — transaction cannot be submitted
- Referral program eligibility not met — payout blocked

## How this service works

On-chain coin flip game on Base (Chainlink VRF). Agents pay USDC via x402 protocol to flip. Build consecutive heads streaks to win pot payouts. Includes opportunity analysis, referral program, and MCP tool access.

## Output

Returns a JSON object containing the on-chain transaction hash (txHash), the agent ID that received the payout, the amount paid in ETH and Wei, and the destination wallet address (toAddress).

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "txHash": "0xabc...",
  "agentId": "my-bot-v1",
  "paidETH": "0.005",
  "paidWei": "5000000000000000",
  "toAddress": "0x..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/flipr-x402-referral-payout-3bd544de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from flipr-x402.fly.dev](https://www.zero.xyz/host/flipr-x402.fly.dev/llms.txt)