Khóa API: nhật ký của bạn trong script của riêng bạn

Pro và Fleet.

API của TakeJournal cho phép script, bảng tính và công cụ lập trình của riêng bạn đọc nhật ký: các tài khoản, các giao dịch như trang Giao dịch hiển thị, lệnh khớp của một tài khoản, thống kê và các nhóm của bảng điều khiển, một ngày hay một tuần cùng ghi chú. API chỉ đọc: không thao tác nào thay đổi nhật ký của bạn hay chạm tới broker của bạn.

Tạo khóa

Hồ sơ → AI và API → + Khóa mới: đặt một cái tên bạn sẽ nhận ra, chọn nội dung được đọc và thời hạn (30, 90 hoặc 365 ngày), rồi bấm Tạo khóa. Khóa (tja_…) chỉ hiện một lần, kèm một lệnh gọi để thử: hãy cất nó trong trình quản lý mật khẩu hoặc kho bí mật của script. TakeJournal chỉ giữ dấu vân tay của khóa, nên khóa bị mất không thể hiện lại: hãy tạo khóa mới. Tối đa mười khóa cùng lúc.

Khóa đọc những gì

Mọi khóa đều đọc tài khoản, giao dịch, lệnh khớp và thống kê. Đánh dấu Ghi chú, nhật ký ngày, đánh giá AI và tin nhắn của Spotter cho khóa cần đọc cả những gì bạn đã viết; nếu không, các phần đó bị bỏ khỏi mọi câu trả lời.

Gọi API

Gửi khóa trong header Authorization:

curl -H "Authorization: Bearer tja_…" "https://app.takejournal.com/api/v1/trades?from=2026-10-01"

Lần gọi	Trả về
GET /api/v1/me	gói, múi giờ, tiền tệ và ngôn ngữ của hồ sơ, phạm vi và hạn của khóa, số lần gọi hôm nay
GET /api/v1/accounts	các tài khoản cùng id, bí danh (ACC-12), tên, số, tiền tệ và trạng thái
GET /api/v1/trades	các giao dịch (một quyết định sao chép sang nhiều tài khoản tính một lần), có lọc và phân trang
GET /api/v1/trades/{id}	một giao dịch cùng nhật ký và giao dịch của nó trên từng tài khoản
GET /api/v1/statistics	thống kê của bảng điều khiển
GET /api/v1/groups?by=weekday	các giao dịch nhóm theo một hoặc hai thuộc tính
GET /api/v1/days/{date}, GET /api/v1/weeks/{date}	một ngày hay một tuần cùng ghi chú, đánh giá AI và tin nhắn của Spotter
GET /api/v1/labels	các thẻ, danh mục và chiến lược
GET /api/v1/accounts/{id}/fills	lệnh khớp của một tài khoản, cũ nhất trước, theo UTC

Bộ lọc giống trang Giao dịch: from và to là ngày giao dịch (YYYY-MM-DD), account theo id hoặc bí danh, symbols, strategy, tags, account_kind, market; danh sách cách nhau bằng dấu phẩy. limit và offset phân trang các giao dịch. Thời gian theo múi giờ của hồ sơ, trừ khi lần gọi ghi UTC. Mọi tham số của mọi lần gọi có trong mô tả API (OpenAPI), không cần khóa.

Giới hạn

Tất cả các khóa của bạn cộng lại: Pro 60 lần gọi mỗi phút, trong đó 20 lần thống kê hoặc nhóm, 5.000 lần mỗi ngày; Fleet 120, 40 và 10.000; hai lần cùng lúc. Lần gọi vượt giới hạn trả về 429 kèm Retry-After, số giây cần chờ; ngày tính theo UTC. Các lần gọi không dùng câu trả lời AI nào của bạn. Hồ sơ → AI và API hiển thị số lần gọi hôm nay.

Thu hồi khóa

Bấm Thu hồi bên cạnh khóa rồi xác nhận: script dùng khóa đó nhận 401 ngay. Khóa cũng ngừng khi hết hạn. Nếu gói của bạn không còn API, các khóa trả về 403 cho đến khi gói có lại API; không cần tạo lại.