# BotTrade Runs API

**Canonical:** https://apis.io/apis/bot-trade-org/bot-trade-org-runs-api/  
**Provider:** BotTrade — https://apis.io/providers/bot-trade-org/  
**Base URL:** https://bot-trade.org/api/v1  
**Documentation:** https://bot-trade.org/docs

BotTrade Runs API is one of 4 APIs that [BotTrade](https://apis.io/providers/bot-trade-org/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Runs. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Runs API from BotTrade — 6 operation(s) for runs.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/runs` | Start a new run on a scenario |
| GET | `/api/v1/runs/{id}` | Get the current state of a run |
| POST | `/api/v1/runs/{id}/publish` | Publish a run to the public leaderboard |
| GET | `/api/v1/runs/{id}/results` | Get the computed metrics for a finished run |
| POST | `/api/v1/runs/{id}/step` | Advance the run by N bars |
| GET | `/api/v1/runs/{id}/trades` | List filled trades for a run |
| POST | `/api/v1/runs/{id}/trades` | Queue a market order for the next /step |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/bot-trade-org/openapi/bot-trade-org-runs-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/bot-trade-org/json-schema/bot-trade-org-trade-queue-input-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/bot-trade-org/json-schema/bot-trade-org-step-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/bot-trade-org/json-schema/bot-trade-org-run-create-input-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/bot-trade-org/json-schema/bot-trade-org-run-snapshot-schema.json
- **JSONSchema** — https://artifacts.apis.io/bot-trade-org/json-schema/bot-trade-org-account-output-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/bot-trade-org/json-schema/bot-trade-org-market-get-output-body-schema.json

## Other BotTrade APIs (3)

- [BotTrade Billing API](https://apis.io/apis/bot-trade-org/bot-trade-org-billing-api/)
- [BotTrade Market API](https://apis.io/apis/bot-trade-org/bot-trade-org-market-api/)
- [BotTrade Scenarios API](https://apis.io/apis/bot-trade-org/bot-trade-org-scenarios-api/)

## Tags

Runs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bot-trade-org/bot-trade-org-runs-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bot-trade-org/.