MY PROP JOURNAL

Trader's Notebook

Personal trader notes and folder organization with rich text content.

Overview

The Trader's Notebook stores personal notes organized into folders. Notes use rich text content (TipTap JSON) with optional tags.


List trader notes

Endpoint: GET /api/v1/trader-notes

Query parameters

ParameterTypeDescription
pageintegerPage number (default 1)
limitintegerItems per page, max 100 (default 20)
folder_idstringFilter by folder UUID, or root for unfiled notes
tag_idsstringComma-separated tag IDs
searchstringSearch in note title
sortstringSort mode: custom, date, or alphabetical (default custom)
formatstringContent format: json, html, or markdown
content_formatstringAlias for format
include_mediabooleanInclude media URLs

Example

curl "https://app.mypropjournal.com/api/v1/trader-notes?folder_id=root&sort=date" \
  -H "Authorization: Bearer mpj_your_api_key_here"

Create trader note

Endpoint: POST /api/v1/trader-notes

FieldTypeRequiredDescription
contentobjectNoTipTap JSON content
folder_idstringNoFolder UUID
tag_idsarrayNoTag IDs to assign
sort_ordernumberNoCustom sort order

Get single trader note

Endpoint: GET /api/v1/trader-notes/{id}

Supports format, content_format, and include_media query parameters.


Update trader note

Endpoint: PATCH /api/v1/trader-notes/{id}

Update content, folder_id, tag_ids, or sort_order.


Delete trader note

Endpoint: DELETE /api/v1/trader-notes/{id}


Trader folders

List folders

Endpoint: GET /api/v1/trader-folders

Returns all folders ordered by sort_order.

Create folder

Endpoint: POST /api/v1/trader-folders

FieldTypeRequiredDescription
namestringYesFolder name
parent_folder_idstringNoParent folder UUID for nesting
colorstringNoHex color (default #6B7280)
sort_ordernumberNoCustom sort order

Get folder

Endpoint: GET /api/v1/trader-folders/{id}

Update folder

Endpoint: PATCH /api/v1/trader-folders/{id}

Update name, parent_folder_id, color, or sort_order.

Delete folder

Endpoint: DELETE /api/v1/trader-folders/{id}

Notes in the deleted folder are moved to root (unfiled).