# FlareHQ

## Docs

- [Deploy an ERC-8004 AI Agent on Arc Testnet](https://docs.flarehq.xyz/agents/deploying-agents.md): Provision a Circle SCA wallet and register on-chain ERC-8004 identity for your AI agent in a single API call to FlareHQ on Arc testnet.
- [Post and Fulfill Agent Jobs with ERC-8183](https://docs.flarehq.xyz/agents/erc8183-jobs.md): Create on-chain job contracts, fund them with USDC, and release payment to AI agents on verified completion using the ERC-8183 standard.
- [Agentic Finance on FlareHQ: AI Agents That Earn and Spend](https://docs.flarehq.xyz/agents/overview.md): Deploy autonomous AI agents with on-chain ERC-8004 identity, Circle SCA wallets, and programmatic access to USDC payments and job contracts.
- [Deploy ERC-8004 Autonomous Agent — POST /api/agent/deploy](https://docs.flarehq.xyz/api-reference/agents/deploy.md): POST /api/agent/deploy — provisions two SCA wallets and registers an ERC-8004 on-chain identity. Returns tokenId, wallet addresses, and txHash.
- [Get Agent Identity and Status — GET /api/agent/status](https://docs.flarehq.xyz/api-reference/agents/status.md): GET /api/agent/status — returns wallet balances, ERC-8004 token IDs, on-chain status, and payment history for agents under your account.
- [Create On-Chain USDC Escrow — POST /api/escrow/create](https://docs.flarehq.xyz/api-reference/escrow/create.md): POST /api/escrow/create — locks USDC in an on-chain escrow contract on Arc testnet. Returns a reference, txHash, and ArcScan explorer link.
- [Raise a Dispute on Escrow — POST /api/escrow/dispute](https://docs.flarehq.xyz/api-reference/escrow/dispute.md): POST /api/escrow/dispute — raises a dispute on an active escrow, locking it until FlareHQ resolves the disagreement. Returns txHash and updated status.
- [Release Locked Escrow Funds — POST /api/escrow/release](https://docs.flarehq.xyz/api-reference/escrow/release.md): POST /api/escrow/release — releases locked USDC to the beneficiary once both parties confirm. Returns txHash and release status.
- [Query On-Chain Escrow Status — GET /api/escrow/status](https://docs.flarehq.xyz/api-reference/escrow/status.md): GET /api/escrow/status?reference= — returns current escrow status, locked amount, both party addresses, deadline, and on-chain transaction details.
- [FlareHQ REST API Reference — Full Developer Overview](https://docs.flarehq.xyz/api-reference/overview.md): Base URL, authentication, request and response format, rate limits, and a complete index of all FlareHQ REST API endpoint groups and paths.
- [USDC Payment History — GET /api/payments/history](https://docs.flarehq.xyz/api-reference/payments/history.md): GET /api/payments/history — paginated list of USDC payment records for your merchant account. Filter by status, date range, and page size.
- [Initialize Payment — POST /api/payments/initialize](https://docs.flarehq.xyz/api-reference/payments/initialize.md): POST /api/payments/initialize — creates a USDC payment session and returns a hosted checkout URL, arc_ref_ reference, and session data for tracking.
- [Verify USDC Payment Status — GET /api/payments/verify](https://docs.flarehq.xyz/api-reference/payments/verify.md): GET /api/payments/verify/{reference} — returns the current status, settled amount, and on-chain txHash for any USDC payment session on FlareHQ.
- [Create USDC Payment Stream — POST /api/payments/stream](https://docs.flarehq.xyz/api-reference/streams/create.md): POST /api/payments/stream — starts a per-second USDC payment stream on Arc testnet. Returns a stream reference, txHash, and estimated end time.
- [List Active Payment Streams — GET /api/payments/stream](https://docs.flarehq.xyz/api-reference/streams/list.md): GET /api/payments/stream — returns all USDC payment streams with real-time balance calculations. Filter by sender, receiver, status, or reference.
- [Stop Payment Stream — POST /api/payments/stream/stop](https://docs.flarehq.xyz/api-reference/streams/stop.md): POST /api/payments/stream/stop — halts an active USDC payment stream and returns the unstreamed balance to the sender's wallet on Arc testnet.
- [Execute an x402 Micro-Payment — POST /api/x402/pay](https://docs.flarehq.xyz/api-reference/x402/pay.md): POST /api/x402/pay — pays for and proxies a marketplace API call. Accepts a payment proof, settles USDC on-chain, and returns the upstream response.
- [x402 Seller Balance, Withdrawal, and Proof Verification](https://docs.flarehq.xyz/api-reference/x402/verify.md): Fetch your x402 USDC earnings, withdraw accumulated funds to any wallet, or verify a buyer's payment proof server-side via the /api/x402 endpoints.
- [FlareHQ API Authentication: Keys, Headers, and Errors](https://docs.flarehq.xyz/authentication.md): FlareHQ uses API key authentication. Learn how to generate Secret and Publishable keys, attach them to requests, and handle auth errors safely.
- [API Error Codes and Troubleshooting Guide](https://docs.flarehq.xyz/developers/errors.md): FlareHQ returns standard HTTP status codes with structured JSON error bodies. Learn what each code means and how to resolve common integration issues.
- [FlareHQ SDKs for Node.js, React, and Python](https://docs.flarehq.xyz/developers/sdks.md): Official FlareHQ client libraries for Node.js, React, and Python with full TypeScript support and real-time USDC payment primitives.
- [Receive Real-Time Events with FlareHQ Webhooks](https://docs.flarehq.xyz/developers/webhooks.md): Register a webhook endpoint to receive HTTP POST notifications for payment, escrow, dispute, and stream lifecycle events in real time.
- [FlareHQ: Web3 Payments Infrastructure for Builders](https://docs.flarehq.xyz/introduction.md): FlareHQ is an API-first payment protocol for USDC checkouts, x402 micro-paywalls, per-second streaming, and on-chain escrow — all settled on Arc testnet.
- [Bridge USDC to Arc Testnet Using Circle CCTP Protocol](https://docs.flarehq.xyz/payments/cctp-bridge.md): Transfer native USDC from Ethereum, Arbitrum, or Solana into Arc testnet with 1:1 capital efficiency and no slippage using Circle CCTP.
- [Programmable Escrow and On-Chain Dispute Resolution](https://docs.flarehq.xyz/payments/escrow-and-disputes.md): Lock USDC in a smart contract on Arc testnet with milestone-based release conditions and arbiter-mediated on-chain dispute resolution.
- [Accept USDC Payments with FlareHQ Hosted Checkout Page](https://docs.flarehq.xyz/payments/hosted-checkout.md): Create a USDC checkout session and redirect customers to FlareHQ's pre-built payment page on Arc testnet. Sessions expire after 120 minutes.
- [Create Shareable and Persistent USDC Payment Links](https://docs.flarehq.xyz/payments/payment-links.md): Generate persistent, reusable USDC checkout URLs for products, subscriptions, or donation pages — no per-transaction checkout session required.
- [Stream USDC Payments to Any Recipient in Real Time](https://docs.flarehq.xyz/payments/streaming-payments.md): Distribute USDC continuously on a per-second basis on Arc testnet. Senders deposit once, recipients withdraw their vested balance at any time.
- [FlareHQ Quickstart: Send Your First USDC Payment in Minutes](https://docs.flarehq.xyz/quickstart.md): Install the FlareHQ SDK, configure your API keys, and send your first USDC checkout session on Arc testnet — all in under 5 minutes.
- [Autonomous AI Agent Payments with x402 and ERC-8004](https://docs.flarehq.xyz/x402/agent-payments.md): Enable AI agents to pay for API access automatically using ERC-8004 on-chain identity and x402 Circle Nanopayments on Arc testnet.
- [FlareHQ x402 Marketplace: Publish and Monetize APIs](https://docs.flarehq.xyz/x402/marketplace.md): List your REST API on the FlareHQ x402 Marketplace. FlareHQ handles proxying, payment verification, and USDC settlement per request.
- [x402 Protocol: HTTP 402 Per-Request API Monetization](https://docs.flarehq.xyz/x402/overview.md): The x402 protocol uses HTTP 402 to charge per API call in sub-cent USDC — no subscriptions, no billing dashboards, automatic settlement.
- [x402 Paywall Setup: Protect API Endpoints with USDC](https://docs.flarehq.xyz/x402/paywall-setup.md): Protect REST endpoints with HTTP 402 micro-payment gates using the FlareHQ middleware. Clients pay per request in USDC automatically.