api 커밍순 오래 걸린다 그래서 그냥 자체적으로 만들었습니다
너는 내 트레이딩 봇 페어 프로그래머야. TxFlow용으로 페이퍼 트레이딩을 기본으로 하는
안전한 퍼프 마켓메이킹 봇을 Python으로 만들어줘.
중요: TxFlow 공식 API 문서는 아직 "Coming Soon"이지만, 와이어 프로토콜은
Hyperliquid 계열(HL-fork)이고 공식 MIT 라이선스 npm 패키지 txflow-sdk에서 전부
도출 가능해. 문서를 기다리지 말고 아래 검증된 스펙을 써:
- REST 베이스 https://api.txflow.com : POST /info (공개 조회), POST /exchange (서명 액션).
시작 단계에선 WebSocket 없이 /info 폴링으로 충분.
- 메인넷 서명 도메인: txflowNetwork="TxFlow-Mainnet", chainId=869, apiVersion=1,
signatureChainId=42161 (SDK 기본 테스트넷 상수를 그대로 믿지 마).
- 에이전트 지갑 패턴: USER 지갑이 ApproveAgent 1회 서명 + 출금 담당, 별도 AGENT
지갑은 거래만. 봇 프로세스는 AGENT 키만 보유.
- 서명: msgpack(action, p/s 문자열 필드의 뒤쪽 0 제거) + 8바이트 빅엔디언 nonce +
vault 플래그 바이트 → keccak256 → EIP-712 "Agent" 타입드 데이터(connectionId = 그 해시)를
agent 키로 서명.
- 함정: 주문/취소 ID는 msgpack에서 반드시 고정 8바이트 정수(JS BigInt64)로 인코딩해야 해.
Python 최소길이 정수로 넣으면 해시가 달라져서 서명이 거부돼.
- 조회: perpmeta(유니버스 + 자산 인덱스·priceTick·szDecimals), l2book(coin = 자산
인덱스를 문자열로, 심볼명 아님), clearinghouseState(자산/포지션), openorders,
userFills(수수료 + closedPnl).
- 주문 tif: "alo"=post-only(메이커), "gtc", "ioc". 수수료: VIP0 메이커 1.5bps / 테이커
4.5bps — 순 PnL에 반드시 반영.
1) 깔끔한 프로젝트 스캐폴드: config, agent 키용 .env, TxFlow 클라이언트, 전략 인터페이스,
기본 DRY_RUN=true(주문은 로그만) 러너.
2) 리스크 컨트롤 먼저: 최대 포지션 크기, 일일 손실 킬스위치, 최대 오픈 주문 수, 가격피드
지연 시 주문거부.
3) l2book mid 기준 인벤토리 스큐 양방향 호가 전략 1개 구현, 플러그인 형태로.
4) 포지션은 매 루프 clearinghouseState에서 읽어 — 내 주문흐름으로 추정하지 마.
5) 모든 단계를 명확히 설명하고 정확한 .env 키와 실행 명령을 나열해.
로그를 검토하고 내가 명시적으로 DRY_RUN=false로 바꾸기 전엔 라이브 주문 절대 금지.
초기에 포인트 더 준다는거 확인해서 초반에 몰아서 파밍하고 놔둘 생각
Txflow