Tapehall Media API
The media API from Tapehall — 6 operation(s) for media.
The media API from Tapehall — 6 operation(s) for media.
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-media-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 Media 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: Media
paths:
/v1/media:
post:
tags:
- Media
summary: Upload Media
operationId: upload_media_v1_media_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:
multipart/form-data:
schema:
$ref: '#/components/schemas/Body_upload_media_v1_media_post'
responses:
'201':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Upload Media V1 Media Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- Media
summary: List Media
operationId: list_media_v1_media_get
parameters:
- name: since
in: query
required: false
schema:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Since
- name: limit
in: query
required: false
schema:
type: integer
maximum: 500
minimum: 1
default: 100
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 Media V1 Media Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/media/chart-screenshot:
post:
tags:
- Media
summary: Post Chart Screenshot
description: Render an official-style chart PNG, store it, return share_url + png_url.
operationId: post_chart_screenshot_v1_media_chart_screenshot_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/ChartScreenshotBody'
responses:
'201':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Post Chart Screenshot V1 Media Chart Screenshot Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/media/{media_id}:
patch:
tags:
- Media
summary: Patch Media
operationId: patch_media_v1_media__media_id__patch
parameters:
- name: media_id
in: path
required: true
schema:
type: string
title: Media 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
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/MediaPatch'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Patch Media V1 Media Media Id Patch
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/media/{media_id}/metrics:
get:
tags:
- Media
summary: Media Metrics
operationId: media_metrics_v1_media__media_id__metrics_get
parameters:
- name: media_id
in: path
required: true
schema:
type: string
title: Media 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 Media Metrics V1 Media Media Id Metrics Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/media/posts/{post_id}/metrics:
get:
tags:
- Media
summary: Post Metrics
operationId: post_metrics_v1_media_posts__post_id__metrics_get
parameters:
- name: post_id
in: path
required: true
schema:
type: string
title: Post 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 Post Metrics V1 Media Posts Post Id Metrics Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/media/ref-click:
post:
tags:
- Media
summary: Ref Click
description: 'Public, no auth: the portal posts this once per landing on /portal?ref=...&m=...'
operationId: ref_click_v1_media_ref_click_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RefClickBody'
required: true
responses:
'204':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
Body_upload_media_v1_media_post:
properties:
file:
type: string
contentMediaType: application/octet-stream
title: File
alt_text:
anyOf:
- type: string
maxLength: 1000
- type: 'null'
title: Alt Text
coin:
anyOf:
- type: string
maxLength: 32
- type: 'null'
title: Coin
kind:
anyOf:
- type: string
maxLength: 16
- type: 'null'
title: Kind
post_id:
anyOf:
- type: string
maxLength: 128
- type: 'null'
title: Post Id
chart_id:
anyOf:
- type: string
maxLength: 16
- type: 'null'
title: Chart Id
ref_code:
anyOf:
- type: string
maxLength: 64
- type: 'null'
title: Ref Code
type: object
required:
- file
title: Body_upload_media_v1_media_post
ChartScreenshotBody:
properties:
symbol:
type: string
maxLength: 64
minLength: 1
title: Symbol
kind:
type: string
enum:
- liq
- px4h
- depth
- cvd
title: Kind
default: liq
alt_text:
anyOf:
- type: string
maxLength: 1000
- type: 'null'
title: Alt Text
tf:
anyOf:
- type: string
maxLength: 8
- type: 'null'
title: Tf
venue:
anyOf:
- type: string
maxLength: 32
- type: 'null'
title: Venue
type: object
required:
- symbol
title: ChartScreenshotBody
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
MediaPatch:
properties:
post_id:
anyOf:
- type: string
maxLength: 128
- type: 'null'
title: Post Id
platform:
type: string
maxLength: 32
title: Platform
default: x
alt_text:
anyOf:
- type: string
maxLength: 1000
- type: 'null'
title: Alt Text
type: object
title: MediaPatch
RefClickBody:
properties:
ref:
type: string
maxLength: 64
title: Ref
m:
anyOf:
- type: string
maxLength: 16
- type: 'null'
title: M
referrer:
anyOf:
- type: string
maxLength: 2048
- type: 'null'
title: Referrer
type: object
required:
- ref
title: RefClickBody