API 토큰
봇이나 채널을 위한 읽기 전용 API예요. 모의 계정 하나를 퍼센트로만 읽고, 아무것도 바꿀 수 없어요.
토큰으로 할 수 있는 일
토큰은 모의 계정 하나를 읽어요. 청산된 거래, 보유 포지션, 통계, PnL 카드를 볼 수 있어요. 모든 값은 금액이 아니라 퍼센트로 나와요. 주문을 넣거나 바꾸거나 취소할 수는 없어요.
토큰 만들기
-
모의 계정 준비하기
토큰은 모의 계정을 읽으니 먼저 하나 만드세요.
-
설정 → API 열기
토큰 이름을 정하고 읽을 계정을 고르세요.
-
바로 복사하기
토큰은 한 번만 표시돼요. 잃어버렸다면 폐기하고 새로 만드세요.
폐기한 토큰을 쓰던 곳은 즉시 작동을 멈춰요.
요청
기본 URL은 https://tarvis.trade/api/v1/agent예요. 모든 요청은 Authorization: Bearer <token> 헤더를 보내요. 시간은 UTC ISO 8601이고, ID는 고정이며, 토큰당 분당 최대 120회 요청할 수 있어요.
curl -H "Authorization: Bearer $TOKEN" https://tarvis.trade/api/v1/agent/me엔드포인트
| 엔드포인트 | 돌려주는 값 |
|---|---|
/trades/closed?since_id=&limit= | since_id 이후에 새로 청산된 거래를 오래된 순으로 돌려줘요. 이걸 폴링하세요. |
/trades/{id}?lang=en|ru | 거래 하나와 진입·청산 이유, 체결 내역 |
/trades/{id}/card.png?theme=&lang=&size= | Telegram에 바로 올릴 수 있는 PnL 카드 |
/positions/open | 계정이 지금 보유한 것 |
/stats?period=7d|30d|all | 승률, 수익 팩터, 낙폭, 수익률. 전체와 전략별로 제공해요 |
/equity?from=&to=&interval=1h|1d | 첫 시점 대비 퍼센트로 나타낸 자산 곡선 |
/equity/card.png?period= | 카드로 만든 자산 곡선 |
/market/candles?symbol=&interval=&from=&to= | 직접 차트를 그릴 때 쓰는 캔들 |
/me | 이 토큰이 유효한지 |
채널 봇, 세 단계로
-
새 거래 폴링하기
마지막으로 본 ID를 넣어
/trades/closed를 호출하세요. 1분에 한 번까지 호출해도 돼요. -
카드 가져오기
새 거래마다
/trades/{id}/card.png를 내려받으세요. -
게시하기
사진을 채널에 보내고, 옆에 내 말을 덧붙이세요.