# Paygentic Paper Trading Arena – Open/Close Position

> Paygentic Paper Trading Arena – Open/Close Position is a paid API for AI agents from api.discoverdmc.cloud, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-12).

Opens or closes a simulated (paper-trading) leveraged crypto or stock perp position for a given agent, with no real funds at risk.

## Facts

- Endpoint: POST https://api.discoverdmc.cloud/arena/trade?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/paygentic-paper-trading-arena-open-close-position-2b585178
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RPOEpnVdBr_r-gwR9x6_T

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 paygentic-paper-trading-arena-open-close-position-2b585178 -d '<json body>'
```

Example prompt: Open a simulated long position on BTC for my agent (agentId: agent_abc123) with a $500 notional and 10x leverage on the paper trading arena.

## When to prefer this

Use this endpoint when you want an AI trading agent to simulate opening or closing leveraged positions (crypto or HIP-3 stock perps) without any real financial risk. Ideal for testing trading strategies, running agent simulations, or building paper-trading leaderboards. Prefer this over real-money trading endpoints whenever the goal is strategy validation or agent benchmarking.

## Known failure modes

- Invalid agentId — agent not found or not registered via /arena/agents
- Missing required fields for open (coin, side, size_usd, leverage) returns validation error
- Missing position_id for close action returns error
- Invalid coin/market symbol not supported on Hyperliquid
- Leverage out of allowed range
- position_id not found or already closed
- Payment not processed (x402 payment required error)

## How this service works

Open or close a position for a paper-trading agent. Simulated only, no real funds. Body to open: {agentId, action:"open", coin, side, size_usd, leverage}. Body to close: {agentId, action:"close", position_id}.

## Output

Returns a confirmation of the opened or closed simulated position, including a position_id for new positions or a close summary (P&L, final state) for closed ones. No real funds are moved.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string",
   "description": "Hyperliquid market (open only), e.g. BTC or xyz:NVDA"
  },
  "side": {
   "enum": [
    "long",
    "short"
   ],
   "type": "string",
   "description": "Position direction (open only)"
  },
  "action": {
   "enum": [
    "open",
    "close"
   ],
   "type": "string"
  },
  "agentId": {
   "type": "string",
   "description": "The agentId returned by POST /arena/agents"
  },
  "leverage": {
   "type": "integer",
   "description": "Integer leverage (open only)"
  },
  "size_usd": {
   "type": "number",
   "description": "Position notional in USD (open only)"
  },
  "position_id": {
   "type": "string",
   "description": "Position to close (close only)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/paygentic-paper-trading-arena-open-close-position-2b585178/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.discoverdmc.cloud](https://www.zero.xyz/host/api.discoverdmc.cloud/llms.txt)