Coinglass API v4
Funding Rate、履歴、Open Interestを取得し、APIレスポンスを正規化します。
Verified Node.js / TypeScript Build · Public Preview
Deploy GuideCoinglass API v4 × PerpDEX × LINE Flex Message
Optimal FR Alert Console
最適FR通知LINE Bot を、実装済みの技術成果物から導入判断できるプロダクトサイトへ変換しました。Funding Rateを取得し、PerpDEX候補を評価し、ランキングをLINEへ通知する一連の運用設計を可視化しています。
TEST SUITES
8passed
UNIT / E2E TESTS
23passed
SCHEDULE
00毎時実行
TOP RANK
5LINE配信
Delta Neutral Funding Spread
ロング/ショート取引所まで分かるデルニュー候補Top5。
同一通貨ペアのPerpDEX別Funding Rateを比較し、FRが高い取引所をショート、FRが低い取引所をロングした場合の差分年利を表示します。各取引所の現在FRが過去24時間平均より高いか低いかも同時に確認できます。
RankPair / SpreadDelta Neutral LegsPerpDEX FRScore
CoinglassからFunding Rateを取得しています。
Implemented Architecture
データ取得からLINE通知までを一気通貫で実装。
Botは、Coinglass API v4からFunding RateとOpen Interestを取得し、PerpDEXホワイトリストで対象を絞り込みます。その後、同一通貨ペアの取引所別FR年利を比較し、Short候補、Long候補、差分年利、24時間平均比をスコア化してLINE通知候補へ変換します。
PerpDEX Filter
ホワイトリスト、別名辞書、ステーブル除外で対象を絞り込みます。
Score Engine
Short候補とLong候補の差分年利、24時間平均比、安定性、流動性を合成します。
SQLite Repository
スナップショット、ランキング、通知ログを保存し監査可能性を担保します。
LINE Flex Message
ヘッダーとランキングBubbleをCarousel化しBroadcastまたはPush送信します。
Dry-run First
初回はLINE送信なしで検証し、本番Broadcast前に状態確認できます。
Execution Flow
監視、評価、記録、通知を一本の運用線に統合。
実装は単なる通知スクリプトではなく、API失敗時のログ、履歴保存、ヘルスチェック、dry-run、手動実行APIを備えた運用可能な構成です。
01
初期化
TypeScript strict、Jest、環境変数テンプレートを整備
02
データ取得
FR、FR履歴、OIをCoinglass API v4から取得
03
選別
PerpDEX候補と銘柄条件をフィルタリング
04
評価
Short年利 − Long年利の差分、24h平均比、流動性から複合スコアを算出
05
保存
SQLiteへランキングと通知ログを永続化
06
通知
上位5件をLINE Flex Messageで配信
Verification Matrix
最終検証済みコマンド
npm test8 suites / 23 tests passed
npm run build本番JavaScript生成成功
npm run dryrunLINE送信なしでランキング処理
curl /health直近実行状態をJSON確認
毎時00分にランキング更新
node-cronがAsia/Tokyo基準で毎時ジョブを実行します。RUN_ON_START=trueにすると起動直後にも1回実行できます。
Secretsは環境変数で管理
Coinglass API KeyとLINE Channel Access Tokenは.envではなく本番環境のSecretsへ設定する構成です。
/health と /rankings/latest
運用中の直近状態と最新ランキングをHTTPで確認できるため、通知前後の検証が容易です。
Production Deployment
永続稼働前に設定する項目。
実アカウントでのBroadcast前に、Secrets、永続ディスク、LINE送信上限、Coinglass API利用権限を確認してください。通知内容は投資助言ではなく、手動確認を前提とした監視情報です。
COINGLASS_API_KEY必須Funding Rate / OI取得
LINE_CHANNEL_ACCESS_TOKEN本番通知時必須Broadcast / Push送信
DRY_RUN推奨初期値 trueLINE送信なしの安全検証
DB_PATH任意SQLite保存先
RUN_ON_START任意起動直後の初回実行
まずDry-run
DRY_RUN=trueでランキング生成とDB保存を確認します。
次にPushテスト
LINE_TEST_USER_IDへFlex Messageを送信し表示を確認します。
最後にBroadcast
送信上限と内容を確認して本番通知へ切り替えます。