Conecta tu agente a trading simulado.

1. Paso uno

   Aprueba una evaluación

   Aprobar permite solicitar una cuenta financiada simulada, sujeta a revisión, verificación y acuerdo. No es una cuenta de corretaje.

2. Paso dos

   Genera una clave API con permisos

   From any page, abrir tu profile menu y choose API keys. Pick read-only o trading scopes y grant the key exactly the cuentas it may touch.

3. Paso tres

   Conecta tu agente

   Point tu bot at our REST API a read state y place órdenes, then reconcile con the ordered event feed. Revoke access anytime.

1. 1

   Obtener an cuenta tu agente puede operar

   Agente keys attach a real Ferm cuentas, so tú need at least one cuenta primer. Any cuenta en an evaluación (active), o already financiado (funded / live), puede operar through the API. Tú puede develop tu bot against an evaluación cuenta y let it earn the financiado one.

   Empezar una evaluaciónLeer el reglamento
2. 2

   Mint tu API key

   Log en en the web, abrir tu profile menu (top right) y choose API keys, then Mint a key. Tú va a pick four things:

   • Nombre: anything that identifies the bot, e.g. "Momentum bot".
   • Permissions: account:read a read, order:write a operar. Empezar read-only if tú son still testing.
   • Cuenta access: the exact cuentas this key may touch. Everything else stays invisible a it.
   • Auto-follow (optional): when an evaluación passes, the key automatically gains access a the financiado cuenta that replaces it, so tu bot keeps running without a manual step.

   The completo key es displayed once. Store it en an environment variable o a secrets manager, never en código o version control. Lost keys cannot be recovered, only replaced.

   # The full key is shown exactly once, at creation. Copy it then.
   # Anatomy: frm_agent_<key id: 16 hex>_<secret: 64 hex>
   
   $ export FERM_AGENT_KEY="frm_agent_1a2b3c4d5e6f7a8b_<64-hex-secret>"
   

3. 3

   Make tu primer request

   List the cuentas tu key fue granted. If this returns tu cuenta, auth, scopes, y grants son all wired up correctly.

   curlPythonJavaScript

   $ curl https://api.tryferm.com/v1/agent/accounts \
     -H "Authorization: Bearer $FERM_AGENT_KEY"
   
   {
     "status": true,
     "data": {
       "accounts": [
         {
           "id": "1f0c9c7e-8f4b-4c6e-9d2a-7b1e3a5c9d10",
           "status": "funded",
           "balanceCents": 10000000,
           "profitShareBps": 9000,
           "createdAt": "2026-06-02T15:04:05.000Z"
         }
       ]
     }
   }
   

   • All money fields son integer cents: 10000000 es $100,000.00.
   • Getting 401? Check the Authorization header made it through tu HTTP client. Getting an empty list? The key has sin cuenta grants yet.
4. 4

   Read live cuenta state

   One call returns everything tu strategy needs a make a decision: equity, buying power, abrir posiciones con live mark prices, working límite órdenes, y how far the cuenta es desde each riesgo límite.

   curlPythonJavaScript

   $ export ACCOUNT_ID="1f0c9c7e-8f4b-4c6e-9d2a-7b1e3a5c9d10"
   
   $ curl https://api.tryferm.com/v1/agent/accounts/$ACCOUNT_ID/state \
     -H "Authorization: Bearer $FERM_AGENT_KEY"
   
   {
     "status": true,
     "data": {
       "tradingState": {
         "account": { "id": "1f0c9c7e-…", "status": "funded", "balanceCents": 10000000 },
         "currentEquityCents": 10038200,
         "buyingPowerCents": 9820000,
         "positions": [
           {
             "id": "6c1d1b2e-4a3f-4f7e-8a9b-2c3d4e5f6a7b",
             "symbol": "BTC",
             "side": "buy",
             "quantity": "0.05",
             "entryPrice": 67210.5,
             "markPrice": 67480.0,
             "unrealizedPnlCents": 1348
           }
         ],
         "pendingOrders": [],
         "riskThresholds": { "maxDrawdownCents": 800000, "dailyLossCents": 400000 },
         "breached": false,
         "progress": { "profitBps": 382, "targetBps": 1000 }
       }
     }
   }
   

   • positions[].id es the id tú use a cerrar a posición o update its brackets; pendingOrders[].id es the id tú use a cancelar a working orden.
   • riskThresholds and progress modalidad the same numbers that score tu evaluación. Use them a tamaño posiciones defensively.
5. 5

   Place tu primer orden

   Generate a fresh UUID as clientOrderId, then send the orden. If tu connection drops mid-request, retry con the same UUID. Tú va a obtener the original result atrás, never a segundo fill.

   curlPythonJavaScript

   $ curl -X POST https://api.tryferm.com/v1/agent/accounts/$ACCOUNT_ID/orders \
     -H "Authorization: Bearer $FERM_AGENT_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "clientOrderId": "8f2b7c1e-0d4a-4c9b-9a1e-1c2d3e4f5a6b",
       "symbol": "BTC",
       "side": "buy",
       "volume": "0.05",
       "orderType": "market",
       "takeProfitPercent": 5,
       "stopLossPercent": 3
     }'
   
   {
     "status": true,
     "data": {
       "order": {
         "status": "filled",
         "fillPrice": 67480.0,
         "position": {
           "id": "6c1d1b2e-4a3f-4f7e-8a9b-2c3d4e5f6a7b",
           "symbol": "BTC",
           "side": "buy",
           "quantity": "0.05"
         }
       }
     }
   }
   

   • Mercado órdenes return status: "filled" con the nuevo posición; límite órdenes return status: "pending" con the working orden.
   • The completo list de orden fields y validation reglas es en Placing órdenes below.
6. 6

   Stay en sync con the event feed

   Fills, cancels, bracket hits, y breaches all land en an ordered event feed. Persist the last sequence tú processed y poll con sinceSequence. After a crash o disconnect tú replay exactly what tú missed.

   curlPythonJavaScript

   # Fetch everything after the last sequence you processed
   $ curl "https://api.tryferm.com/v1/agent/events?accountId=$ACCOUNT_ID&sinceSequence=10431&limit=100" \
     -H "Authorization: Bearer $FERM_AGENT_KEY"
   
   {
     "status": true,
     "data": {
       "events": [
         {
           "eventId": "b1c2d3e4-5f6a-4b7c-8d9e-0f1a2b3c4d5e",
           "sequence": 10432,
           "type": "order_filled",
           "occurredAt": "2026-07-12T08:14:22.101Z",
           "accountId": "1f0c9c7e-8f4b-4c6e-9d2a-7b1e3a5c9d10",
           "clientOrderId": "8f2b7c1e-0d4a-4c9b-9a1e-1c2d3e4f5a6b",
           "data": { }
         }
       ]
     }
   }
   

   • Poll every segundo o two; each request returns up a 500 events.
   • Delivery es at-least-once, so dedupe by eventId before acting.

#!/usr/bin/env python3
"""Ferm starter bot: reads state, places one bracketed order, tails events.

Run it:  export FERM_AGENT_KEY="frm_agent_..." && python3 bot.py
Needs:   pip install requests
"""
import os, time, uuid, requests

API = "https://api.tryferm.com"
HEADERS = {"Authorization": f"Bearer {os.environ['FERM_AGENT_KEY']}"}

def get(path, **params):
    res = requests.get(f"{API}{path}", headers=HEADERS, params=params, timeout=10)
    res.raise_for_status()
    return res.json()["data"]

# 1. Find an account this key can trade
account = get("/v1/agent/accounts")["accounts"][0]
account_id = account["id"]
print(f"trading account {account_id} ({account['status']})")

# 2. Look before you leap: never trade a breached account
state = get(f"/v1/agent/accounts/{account_id}/state")["tradingState"]
if state["breached"]:
    raise SystemExit("account is breached - read-only until further notice")
print(f"equity ${state['currentEquityCents'] / 100:,.2f}")

# 3. Place one small bracketed market order, idempotently
order = {
    "clientOrderId": str(uuid.uuid4()),  # reuse on retry: never double-fills
    "symbol": "BTC",
    "side": "buy",
    "volume": "0.01",
    "orderType": "market",
    "takeProfitPercent": 5,
    "stopLossPercent": 3,
}
res = requests.post(f"{API}/v1/agent/accounts/{account_id}/orders",
                    headers=HEADERS, json=order, timeout=10)
res.raise_for_status()
print("order:", res.json()["data"]["order"]["status"])

# 4. Tail the event feed - real bots persist `since` across restarts
since, seen = 0, set()
while True:
    feed = get("/v1/agent/events", accountId=account_id,
               sinceSequence=since, limit=100)
    for event in feed["events"]:
        since = event["sequence"]
        if event["eventId"] in seen:
            continue  # delivery is at-least-once - dedupe by eventId
        seen.add(event["eventId"])
        print(f"[{event['sequence']}] {event['type']}")
    time.sleep(2)

• Runs en stock Python 3 plus requests. Sin SDK, sin framework. The whole API fits en plain HTTP.
• Swap step 3 para tu own strategy; steps 1, 2, y 4 (cuenta discovery, health check, event tailing) son the plumbing every bot needs.
• Real bots debe persist sinceSequence somewhere durable so a restart replays exactly the events they missed.

Use de the Agente API es authorized programmatic access under Section 6.2 de the Terms y Conditions. Everything tu keys do es attributed a tu cuenta, y the Acceptable Use Policy y all trading reglas apply exactly as they do a manual trading.