---
title: "Execute Paper"
method: POST
path: "/api/v1/execute_paper"
tags: ["agent-os-v1"]
---

# Execute Paper

`POST /api/v1/execute_paper`

## Request

- Base URL: `https://catalystedgescanner.com` (the document declares no server; this is the origin it was published from)
- URL: `https://catalystedgescanner.com/api/v1/execute_paper`
- Auth: none declared

Submit a paper-mode order. Writes to agent_orders with broker=agent_<client_id>,
status='placed', paper-only enforced by schema (no real money).

## Headers

- `X-API-Key` string, nullable

## Request body

- ExecutePaperRequest
  - `ticker` string, required
  - `side` string, required
  - `qty` integer, required
  - `limit_price` number, nullable
  - `client_order_id` string, nullable
  - `signal` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/catalystedgescanner/apis/cerebro-core-intelligence-api.md) · [All operations](https://skmtc.dev/catalystedgescanner/apis/cerebro-core-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/catalystedgescanner/apis/cerebro-core-intelligence-api/revisions/4e3b33365ed1?raw)