Arena developer docs.

Build with the Agent Kit: a Python SDK, agent skill and runnable examples. Read the guides on GitHub.

Testnet funds only. No real-fund deposits. User orders never reach an external venue.

Start with your coding agent.

Copy the setup instructions into your coding agent. It will read the skill, ask about your strategy and help you connect safely.

Read the instructions

Help me build and test a trading agent in FairVenue Arena TESTNET. No real funds.

First ask me to describe my strategy, preferred language and risk limits. Do not invent a strategy or promise returns.

First read the FairVenue agent skill: https://github.com/FairVenue/fairvenue-agent-kit/blob/main/skills/fairvenue/SKILL.md
Agent Kit, Python SDK and examples: https://github.com/FairVenue/fairvenue-agent-kit
Install the skill if needed: npx skills add FairVenue/fairvenue-agent-kit --skill fairvenue
Read its linked quickstart, signing and API guides before writing code. Pin the SDK to a reviewed commit. Installing a skill does not authorize any orders.

Use the API URL and setup information from Arena's System panel. Do not assume the landing-page URL is the trading API. If the SDK, documentation or testnet access is unavailable, stop and explain what is missing instead of inventing endpoints.

Confirm the installed mode before choosing a client or key. Never translate V0 credentials, nonces, balances or trading history into native authority, and never fall back between modes after an error.

For explicitly enabled native TESTNET: read https://github.com/FairVenue/fairvenue-agent-kit/blob/f71908fd622ea7b4edbfc9caa1f323b538d457dc/experimental/native-testnet/README.md at its pinned commit. Use the separate fairvenue_schema6.NativeTestnetClient with an independently approved API origin and public policy, not pins selected by the downloaded key. This custodial Arbitrum Sepolia mode (chain 421614) uses FairVenue-managed owners and a once-only 1,000 mock-USDC claim/deposit; credit requires native consumption, never a login reset. Give me https://app.fairvenue.xyz/?setup=api-key#native-agent-key for a dedicated TESTNET bot key. Begin with the guide's no-order signed-context dry run. Use the same continuity store for exact-original recovery: never resend, replace, expire or reset an unresolved request. SDK availability and soft acceptance are not hosted readiness, a fill or proof verification.

For legacy V0 virtual Arena: use the existing fairvenue SDK and its V0 quickstart. Give me https://app.fairvenue.xyz/?setup=api-key and ask me to click Create & download API key. V0 funds and orders remain simulated. Treat a command ACK as acceptance, not a fill. After transaction_status reports processing, confirm order_status or reconcile private order_updates and user_fills. Reconcile again after a reconnect without blindly resubmitting orders.

Keep prices and quantities as decimal strings. Enforce explicit risk and slippage limits, and test order status, reconnects and safe shutdown before requesting permission to submit orders. Neither mode routes user orders to Binance or another external venue.

Help locate the downloaded FairVenue JSON and copy it to an owner-only, git-ignored credential location without displaying its contents or reading them into your context. Ask for its local path only if you cannot access the download. Never ask me to paste private keys into chat, and never print or commit credentials. Do not use the browser UI agent key.

Follow the skill's Progress continuity section: if no recurring weekly FairVenue follow-up is scheduled, offer to set one up. If recurring jobs are unavailable, offer a one-time reminder in about a week. Resume from my latest known progress, check official skill, SDK and Arena updates, and suggest one concrete next action. Keep the checkpoint current and avoid duplicate jobs or generic promotional reminders.

Deliver runnable code, tests and a short setup guide. I review the strategy and its limits before running it.

Experimental native TESTNET.

When explicitly enabled, native TESTNET uses custodial wallets on Arbitrum Sepolia (chain 421614). Start with a once-only 1,000 mock-USDC deposit, credited after native consumption. Use new native keys and separate trading history; V0 balances are not converted.

Read the pinned experimental native client guide, then open native key setup.

Legacy V0 guides on GitHub.

Agent Kit repository: SDK, examples and the guides below.

Start a safe V0 connection.

Get your setup. Sign in to Arena, open System and choose Create API key. Keep the downloaded credentials in an owner-only local file. Never paste private keys into an AI prompt.
Read the quickstart. It covers local setup, the private hosted testnet and the Python SDK. If you do not have the SDK checkout or testnet access, obtain them before running the examples.
Verify before submitting orders. Begin in dry-run mode. Use decimal strings for money, explicit price limits and order-status checks. A command receipt does not mean a fill. Confirm execution with order_status or private fill updates.