Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mrtrades-com:mrtrades-com-journal-api"
All apis
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.
Get an API 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 Specification
openapi: 3.2.0
info:
title: Tapehall Journal 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: Journal
description: Trade journal and position tracking
paths:
/v1/journal/sync:
post:
tags:
- Journal
summary: Sync Exchange
description: 'Pull recent fills from the linked exchange (e.g. Hyperliquid) into the journal.
Uses the wallet address you signed in with; no exchange API keys required for Hyperliquid.'
operationId: sync_exchange_v1_journal_sync_post
parameters:
- name: venue
in: query
required: true
schema:
type: string
description: 'Exchange to sync: hyperliquid'
title: Venue
description: 'Exchange to sync: hyperliquid'
- name: force
in: query
required: false
schema:
type: boolean
description: Bypass min-interval throttle (manual refresh)
default: false
title: Force
description: Bypass min-interval throttle (manual refresh)
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sync Exchange V1 Journal Sync Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/journal/settings:
get:
tags:
- Journal
summary: Get Journal Settings
description: Per-user background auto-sync toggle (default off).
operationId: get_journal_settings_v1_journal_settings_get
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Get Journal Settings V1 Journal Settings Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
put:
tags:
- Journal
summary: Put Journal Settings
operationId: put_journal_settings_v1_journal_settings_put
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/JournalSettingsBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Put Journal Settings V1 Journal Settings Put
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/journal/sync/status:
get:
tags:
- Journal
summary: Sync Status
description: Return last sync time per venue for the current user.
operationId: sync_status_v1_journal_sync_status_get
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Sync Status V1 Journal Sync Status Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/journal:
get:
tags:
- Journal
summary: List Entries
description: 'Journal fills plus totals.
``items`` is the newest ``limit`` fills (display list). ``summary``,
``summary_by_account``, ``series`` and ``closed_positions`` are computed over
the whole ``since``..``until`` range, not over ``items``: before this, the
headline total was whatever the last ``limit`` fills added up to.
Round-trips are walked over the full history up to ``until`` per wallet, then
kept when they closed inside the range, so a range start never cuts a
position in half.'
operationId: list_entries_v1_journal_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
default: 50
title: Limit
- name: age_format
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Age Format
- name: since
in: query
required: false
schema:
anyOf:
- type: string
format: date-time
- type: 'null'
description: 'Totals/round-trips from this time (ISO 8601). Default: all history.'
title: Since
description: 'Totals/round-trips from this time (ISO 8601). Default: all history.'
- name: until
in: query
required: false
schema:
anyOf:
- type: string
format: date-time
- type: 'null'
description: 'Totals/round-trips up to this time (ISO 8601). Default: now.'
title: Until
description: 'Totals/round-trips up to this time (ISO 8601). Default: now.'
- name: account
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'main | long | short | 0x address. Default: all wallets.'
title: Account
description: 'main | long | short | 0x address. Default: all wallets.'
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response List Entries V1 Journal Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
post:
tags:
- Journal
summary: Create Entry
operationId: create_entry_v1_journal_post
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Create Entry V1 Journal Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/journal/{entry_id}:
patch:
tags:
- Journal
summary: Update Entry
operationId: update_entry_v1_journal__entry_id__patch
parameters:
- name: entry_id
in: path
required: true
schema:
type: integer
title: Entry Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Update Entry V1 Journal Entry Id Patch
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- Journal
summary: Delete Entry
operationId: delete_entry_v1_journal__entry_id__delete
parameters:
- name: entry_id
in: path
required: true
schema:
type: integer
title: Entry Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Delete Entry V1 Journal Entry Id Delete
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/journal/positions:
get:
tags:
- Journal
summary: List Positions
description: 'Open positions from the same exchange read Positions uses.
Each live row also carries ``opened_at``, ``age_s``, ``age`` and ``age_source`` (0.4.318), and ``age_exact`` (0.4.330: ``false`` = a proven lower bound, ``age`` reads ``>Ns``).
``age_format`` is seconds, minutes, hms or auto; it defaults to the user''s saved choice.
A wallet with no master address still walks journal fills. That walk is not
the open uPnL once the exchange account can be read.'
operationId: list_positions_v1_journal_positions_get
parameters:
- name: age_format
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Age Format
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response List Positions V1 Journal Positions Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/journal/books:
get:
tags:
- Journal
summary: List Books
description: 'The long book and the short book, and the coins open on each. 0.4.318: positions, orders and fills have age_s / age.'
operationId: list_books_v1_journal_books_get
parameters:
- name: age_format
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Age Format
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response List Books V1 Journal Books Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
post:
tags:
- Journal
summary: Save Books
operationId: save_books_v1_journal_books_post
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/BooksBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Save Books V1 Journal Books Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/journal/books/close:
post:
tags:
- Journal
summary: Close Saved Book
operationId: close_saved_book_v1_journal_books_close_post
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/BookCloseBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Close Saved Book V1 Journal Books Close Post
'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
CreateBody:
properties:
symbol:
anyOf:
- type: string
- type: 'null'
title: Symbol
venue:
anyOf:
- type: string
- type: 'null'
title: Venue
side:
anyOf:
- type: string
- type: 'null'
title: Side
qty:
anyOf:
- type: number
- type: 'null'
title: Qty
price:
anyOf:
- type: number
- type: 'null'
title: Price
entry_ts:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Entry Ts
tags:
items:
type: string
type: array
title: Tags
notes:
anyOf:
- type: string
- type: 'null'
title: Notes
meta:
additionalProperties: true
type: object
title: Meta
type: object
title: CreateBody
BookCloseBody:
properties:
address:
type: string
title: Address
symbol:
type: string
title: Symbol
fraction:
type: number
title: Fraction
default: 1.0
type: object
required:
- address
- symbol
title: BookCloseBody
UpdateBody:
properties:
symbol:
anyOf:
- type: string
- type: 'null'
title: Symbol
venue:
anyOf:
- type: string
- type: 'null'
title: Venue
side:
anyOf:
- type: string
- type: 'null'
title: Side
qty:
anyOf:
- type: number
- type: 'null'
title: Qty
price:
anyOf:
- type: number
- type: 'null'
title: Price
entry_ts:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Entry Ts
tags:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Tags
notes:
anyOf:
- type: string
- type: 'null'
title: Notes
meta:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Meta
type: object
title: UpdateBody
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
BooksBody:
properties:
long:
anyOf:
- type: string
- type: 'null'
title: Long
short:
anyOf:
- type: string
- type: 'null'
title: Short
type: object
title: BooksBody
JournalSettingsBody:
properties:
auto_sync:
type: boolean
title: Auto Sync
type: object
required:
- auto_sync
title: JournalSettingsBody