Tapehall Control API
The control API from Tapehall — 9 operation(s) for control.
The control API from Tapehall — 9 operation(s) for control.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mrtrades-com:mrtrades-com-control-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Tapehall Control API
description: 'Crypto-native perp screener and charting API.
**Auth**: Most endpoints accept `X-Api-Key` header. WebSocket endpoints use the `mtdp` subprotocol with API key.
Tier ≥1 required for live streams (scan, screener, chart candles, chart DOM).
**Rate limit**: per API key / session / IP sliding window (default 1200 cost units/min per key or session, 300/min per unauthenticated IP; heavy routes cost 10), max 16 concurrent requests per key. Over limit: 429 with Retry-After. Requests that have not started responding in 30s (90s heavy) get 504.'
version: 1.0.4
tags:
- name: Control
paths:
/v1/control/catalog:
get:
tags:
- Control
summary: Get Catalog
operationId: get_catalog_v1_control_catalog_get
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Get Catalog V1 Control Catalog Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/control:
get:
tags:
- Control
summary: List Devices
operationId: list_devices_v1_control_get
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response List Devices V1 Control Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/control/flatten/preview:
post:
tags:
- Control
summary: Flatten Preview
operationId: flatten_preview_v1_control_flatten_preview_post
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PreviewBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Flatten Preview V1 Control Flatten Preview Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/control/wish:
post:
tags:
- Control
summary: Run Wish
description: 'Virtual Control / MCP: run a mapped wish. Risk wishes stay preview-only.'
operationId: run_wish_v1_control_wish_post
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/WishBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Run Wish V1 Control Wish Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/control/events:
get:
tags:
- Control
summary: List Events
operationId: list_events_v1_control_events_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
default: 20
title: Limit
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response List Events V1 Control Events Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/control/flatten:
post:
tags:
- Control
summary: Flatten Run
description: FIRE a planned job. Live HL posts stay off until deREDACTED_STRIPE_KEY is enabled.
operationId: flatten_run_v1_control_flatten_post
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/FlattenBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Flatten Run V1 Control Flatten Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/control/jobs:
get:
tags:
- Control
summary: List Jobs
operationId: list_jobs_v1_control_jobs_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
default: 20
title: Limit
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response List Jobs V1 Control Jobs Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/control/jobs/{job_id}:
get:
tags:
- Control
summary: Get Job
operationId: get_job_v1_control_jobs__job_id__get
parameters:
- name: job_id
in: path
required: true
schema:
type: integer
title: Job Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Get Job V1 Control Jobs Job Id Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/control/jobs/{job_id}/cancel:
post:
tags:
- Control
summary: Cancel Job
description: Stop a planned or soft-running job. Waves already posted stay fail-closed.
operationId: cancel_job_v1_control_jobs__job_id__cancel_post
parameters:
- name: job_id
in: path
required: true
schema:
type: integer
title: Job Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Cancel Job V1 Control Jobs Job Id Cancel Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
PreviewBody:
properties:
mode:
anyOf:
- type: string
- type: 'null'
title: Mode
rank:
anyOf:
- type: string
- type: 'null'
title: Rank
cancel_orders:
anyOf:
- type: boolean
- type: 'null'
title: Cancel Orders
device_id:
anyOf:
- type: integer
- type: 'null'
title: Device Id
type: object
title: PreviewBody
FlattenBody:
properties:
job_id:
anyOf:
- type: integer
- type: 'null'
title: Job Id
nonce:
anyOf:
- type: string
- type: 'null'
title: Nonce
idempotency_key:
anyOf:
- type: string
- type: 'null'
title: Idempotency Key
mode:
anyOf:
- type: string
- type: 'null'
title: Mode
rank:
anyOf:
- type: string
- type: 'null'
title: Rank
cancel_orders:
anyOf:
- type: boolean
- type: 'null'
title: Cancel Orders
device_id:
anyOf:
- type: integer
- type: 'null'
title: Device Id
type: object
title: FlattenBody
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
WishBody:
properties:
wish:
type: string
title: Wish
key_id:
anyOf:
- type: string
- type: 'null'
title: Key Id
params:
additionalProperties: true
type: object
title: Params
device_id:
anyOf:
- type: integer
- type: 'null'
title: Device Id
job_id:
anyOf:
- type: integer
- type: 'null'
title: Job Id
nonce:
anyOf:
- type: string
- type: 'null'
title: Nonce
type: object
required:
- wish
title: WishBody
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError