https://router.fluxapay.xyz/api/blockrun/{CREATOR_UID}Generations: AI music generation API - pay per track with USDC on Base
Sound Effects: AI sound effect generation (ElevenLabs) â pay per call with USDC on Base
Speech: AI text-to-speech (ElevenLabs) â pay per call with USDC on Base
Completions: AI chat completions API - pay per request with USDC on Base
Exa answer: Get an AI-generated answer to a question grounded in live web search results.
Exa page contents: Extract full text content from specific URLs. Priced at $0.002/URL â total = urls.length à $0.002.
Exa find similar: Find pages semantically similar to a given URL.
Generations: AI image generation API - pay per image with USDC on Base (hybrid sync/async)
Image2image: AI image editing API - edit images with USDC on Base
Messages: Anthropic-compatible Messages API â pay per token with USDC on Base
Create Modal sandbox: Create a managed Python 3.11 sandbox. Two billing modes selected by 'timeout': â¤300s = flat rate (CPU $0.01, GPU varies). >300s = per-hour billing for the full requested lifetime, no refund on early terminate. Max 24h.
Buy phone number: Purchase a dedicated phone number valid for 30 days. The number is bound to your wallet address. Default country is US (no regulatory friction). Other countries can be requested via the `country` parameter, but Twilio may require a Regulatory Bundle (KYC) on our account before purc
List phone numbers: List all active phone numbers provisioned to your wallet.
Binance BTC/USDT candles: Get OHLCV candlestick data for a Binance trading pair
/api/v1/pm/binance/candles/ETHUSDT: Get OHLCV candlestick data for a Binance trading pair
/api/v1/pm/binance/candles/SOLUSDT: Get OHLCV candlestick data for a Binance trading pair
/api/v1/pm/binance/ticks/BTCUSDT: Get raw book ticker data at microsecond granularity
Binance ETH/USDT ticks: Get raw book ticker data at microsecond granularity
Kalshi orderbooks: Fetch historical orderbook snapshots for a Kalshi market
Kalshi trades: Fetch historical Kalshi trade data
Limitless markets: List Limitless markets with filtering and sorting
Orderbooks: Fetch historical orderbook snapshots for a Limitless market
Search prediction markets: Search markets across Polymarket, Kalshi, Limitless, Opinion, and Predict.Fun in a single call
Opinion markets: List Opinion markets with filtering and sorting
Orderbooks: Fetch historical orderbook snapshots for an Opinion market
Polymarket activity: Fetch trading activity (merges, splits, redeems) for a user
/api/v1/pm/polymarket/candlesticks/:hash: Get historical OHLCV candlestick data for a market
Polymarket cohort stats: Compare performance across trading style cohorts
Polymarket events (keyset page): List Polymarket events with cursor-based keyset pagination
/api/v1/pm/polymarket/leaderboard/market/:condition_id: Get leaderboard for a specific market
Polymarket leaderboard by market: Get leaderboard for a specific market
Test: Get leaderboard for a specific market
/api/v1/pm/polymarket/market-price/2143401858385894894190399172754859063760192107542405534567206954789995051162: Get current or historical price for a specific token
Polymarket market price: Get current or historical price for a specific token
Polymarket market price (alt market): Get current or historical price for a specific token
Smart Money: View smart money positioning on a specific market
Top Holders: Get top holders for a specific market ranked by position size
Volume: Get historical cumulative volume data for a market
Volume: Get historical cumulative volume data for a market
Volume: Get historical cumulative volume data for a market
Volume: Get historical cumulative volume data for a market
Polymarket markets (keyset page): List Polymarket markets with cursor-based keyset pagination (same filters as /polymarket/markets)
Polymarket smart-money activity: Discover markets where high-performing wallets are active
Volume: Get historical cumulative volume data for a market
Polymarket market volume: Get historical cumulative volume data for a market
Polymarket orderbooks: Get historical orderbook snapshots for a token
Polymarket positions: Fetch all user positions with filtering and pagination
Polymarket trades: Query historical Polymarket trade data with flexible filtering
Markets: List UMA oracle questions filtered by state (proposed, disputed, resolved, â¦)
/api/v1/pm/polymarket/wallet/:address: Get a complete smart wallet profile with all metrics
/api/v1/pm/polymarket/wallet/positions/:address: Get open and historical positions for a wallet address
Filter Polymarket wallets: Filter wallets by market trades with AND/OR logic
Profiles: Batch retrieve wallet profiles for multiple addresses
Predict.fun markets: List Predict.Fun markets with filtering and sorting
Orderbooks: Fetch historical orderbook snapshots for a Predict.Fun market
Search: Grok Live Search API - real-time web and news search
Generations: AI video generation API - pay per second with USDC on Base
Call: Initiate an AI-powered outbound phone call via Bland.ai.
Copy this prompt and paste it into your AI agent (like Claude, GPT-4, etc.) to enable automatic X-402 payment handling.
** Your task ** Call the API at: https://router.fluxapay.xyz/api/blockrun/{CREATOR_UID}
Follow the steps below in order.
** Step 1 - Install FluxA Wallet CLI **
npm install -g @fluxa-pay/fluxa-wallet
Or use without installing: npx fluxa-wallet <command>
** Step 2 - Register agent **
fluxa-wallet init --name "<YOUR_AGENT_NAME>" --client "<YOUR_CLIENT>"
The response may include an authorization URL. Present the user with options: [Yes, open the link] [No, don't open]. If YES: run 'open "<URL>"' to open in their browser.
Verify: fluxa-wallet status
** Step 3 - Discover endpoints **
curl https://router.fluxapay.xyz/api/blockrun/{CREATOR_UID}
Returns JSON with: name, description, endpoints (paths, methods, descriptions, prices), paymentRequired, and networks.
** Step 4 - Choose payment method **
Ask the user: [On-chain USDC (Base)] or [FluxA Monetize Credits]
If USDC:
- --currency USDC
- --amount in atomic units (6 decimals, e.g., 100000 = 0.10 USDC)
If Credits (1 credit = 1 USDC):
- --currency FLUXA_MONETIZE_CREDITS
- --amount in 2-decimal units (e.g., 10 = 0.10 credits, 100 = 1.00 credits)
** Step 5 - Create an intent mandate **
x402 v3 uses intent mandates: the user pre-approves a spending plan (budget + time window), then the agent makes autonomous payments within those limits.
fluxa-wallet mandate-create \
--desc "Spend up to <BUDGET> for <DESCRIPTION> valid for <DURATION>" \
--amount <BUDGET_IN_UNITS> \
--seconds <DURATION_IN_SECONDS> \
--currency <USDC or FLUXA_MONETIZE_CREDITS>
Options:
- --desc (required): Human-readable spending plan description
- --amount (required): Budget in units for the chosen currency (see Step 4)
- --seconds (optional, default 28800 = 8h): Duration in seconds
- --currency (optional, default USDC): USDC or FLUXA_MONETIZE_CREDITS
** Step 6 - Get user to sign the mandate **
The response from Step 5 includes mandateId and authorizationUrl (TTL: 10 minutes).
Present the user with options: [Yes, open the link] [No, don't open]. If YES: run 'open "<authorizationUrl>"' to open in their browser.
** Step 7 - Wait for mandate to be signed **
fluxa-wallet mandate-status --id <MANDATE_ID>
Poll until mandate.status is "signed". The response also includes remainingAmount.
Important: Use --id, not --mandate.
** Step 8 - Call the API **
curl https://router.fluxapay.xyz/api/blockrun/{CREATOR_UID}
Optionally add the X-Agent-ID header for agent attribution (its value is the agent_id from 'fluxa-wallet status'): curl -H "X-Agent-ID: <YOUR_AGENT_ID>" https://router.fluxapay.xyz/api/blockrun/{CREATOR_UID}
If it returns HTTP 402, continue to Step 9.
** Step 9 - Pay via x402 v3 **
Pass the complete HTTP 402 response body as --payload:
fluxa-wallet x402-v3 \
--mandate <MANDATE_ID> \
--payload '$PAYLOAD_402'
The payload must contain an accepts array. Do NOT extract individual fields - pass the entire 402 response JSON.
The response includes xPaymentB64 (the payment token).
** Step 10 - Retry with payment token **
Retry the same request with the X-Payment header (optionally add X-Agent-ID for attribution):
curl -H "X-Payment: <xPaymentB64>" <ORIGINAL_API_URL>
Return the raw API response to the user without post-processing.
** Opening links for user **
Whenever you need to open a URL (authorization, approval, or any external link):
1. Present the user with a choice using your interactive options/menu capability (e.g., AskUserQuestion tool)
2. Options: [Yes, open the link] [No, don't open]
3. If YES: run 'open "<URL>"' to open in their default browser
4. If NO: ask how they would like to proceed
** Error handling **
- mandate_not_signed: User hasn't signed yet - ask them to open authorizationUrl
- mandate_expired: Time window passed - create a new mandate
- mandate_budget_exceeded: Budget too low - create a new mandate with a higher limit
- agent_not_registered: No Agent ID - run 'fluxa-wallet init' first
- Invalid payload: missing accepts array: Pass the full 402 response JSON