추천 대상: Agent / API로 Traseq를 연동하는 개발자

Agent 또는 API 클라이언트로 Traseq 다루기

노코드 에디터가 만들어 내는 작성 합의인 SignalGraph v2가 곧 API가 기대하는 것입니다. Agent와 UI가 서로 어긋날 수 없습니다.

핵심 개념

API key: 워크스페이스 설정에서 생성합니다. 각 요금제는 하나의 워크스페이스가 동시에 보유할 수 있는 key 수를 제한합니다.
Capabilities 능력 탐색: 먼저 /capabilities를 읽으세요. 지금 이 워크스페이스가 어떤 fields, operators, instruments를 지원하는지 agent에게 알려 줍니다. 하드코딩이 필요 없습니다.
SignalGraph 검증: 모든 전략 쓰기는 스키마와 의미 규칙에 대해 검사됩니다. 잘못된 graph는 구조화된 diff와 함께 거부되어, agent가 스스로 복구할 수 있습니다.
Create / finalize: 작성은 두 단계입니다. 먼저 초안을 create하고, 그다음 finalize해서 버전이 있는 스냅샷으로 잠급니다. 백테스트는 확정된 버전에 대해서만 실행됩니다.
Queue backtest: 백테스트는 engine에서 비동기로 실행됩니다. 제출하면 run id를 받고, 이후 run을 poll하거나 결과 이벤트를 스트리밍합니다.

당신의 다음 단계

Traseq에서는 이렇게 보입니다

워크스페이스 설정에서 API key를 생성합니다.

/capabilities를 호출해, 환경이 agent가 기대하는 것과 맞는지 확인합니다.

SignalGraph v2 전략을 만들고, 검증한 뒤, 버전을 finalize합니다.

확정된 버전에 대해 백테스트를 큐에 넣고, run을 읽어 옵니다.