FINGER TRADER

開発者向けオンボーディング

Finger Trader API 開発ガイド

製品別ドキュメントを読む前に、まずアカウント要件を確認し、サインインして Access Token を取得し、認証が必要な API リクエストで使用する方法を確認してください。

ドキュメント構成 · 概要

API リクエストの前に

Finger Trader API はアカウントセッションで呼び出し元を識別します。アカウントの利用条件を満たし、サインインしてから認証が必要な業務 API を呼び出してください。

アカウントの前提条件

  • Finger Trader アカウントが有効化されていること。
  • Finger エコシステム内のブローカーで口座を開設していること。

1. サインインして Access Token を取得

アプリは OAuth 2.0 password grant で認証サービスから Access Token を取得します。メールログインの type は 1、携帯電話ログインは 2 です。captchaId と captchaCode はサービスから CAPTCHA を求められた場合のみ含めてください。

本番 Token エンドポイント
POST https://prod-api.fingertrader.com/finger-auth/oauth2/token
ヘッダー
Authorization: Basic <APP_CLIENT_CREDENTIALS>
Content-Type: application/x-www-form-urlencoded
フォーム項目
grant_type=password
username=<EMAIL_OR_PHONE>
password=<PASSWORD>
type=1  # email; use 2 for mobile

The Flutter app supplies its configured client credential. It is intentionally not included in this public documentation or browser-based Try it tool.

Token レスポンス(アプリが使用する項目)
{
  "code": 0,
  "data": {
    "access_token": "<ACCESS_TOKEN>",
    "refresh_token": "<REFRESH_TOKEN>",
    "token_type": "Bearer",
    "expires_in": 0
  },
  "msg": ""
}

2. リクエストヘッダーに Access Token を設定

サインイン応答の access_token を使用します。アプリのフローでは token_type は Bearer です。refresh_token を業務 API に送信しないでください。

Authorization ヘッダー
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

3. Finger Trader BFF API を呼び出す

Flutter アプリは業務リクエストを BFF API Base URL に JSON で送信し、サインイン中は Authorization セッションヘッダーを付与します。掲載した API パスはアプリの実装に基づいています。

本番 API Base URL
https://prod-api.fingertrader.com/finger-bff-app
POST /app-api/v1/market/ticker-list
curl --request POST 'https://prod-api.fingertrader.com/finger-bff-app/app-api/v1/market/ticker-list' \\
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \\
  --header 'Content-Type: application/json' \\
  --data '{"page":1,"pageSize":10,"query":{"marketType":null,"brokerId":null}}'
一般的なレスポンス形式
{
  "code": 0,
  "data": { "total": 0, "items": [] },
  "msg": ""
}

API リクエストを試す

Access Token と /app-api/v1 配下の POST パスを入力してください。選択した Finger Trader 公式 API 環境へブラウザーから直接送信します。

準備完了です。「リクエストを送信」を押すまで送信されません。

応答
応答がここに表示されます。

Token はこのページのメモリ内にのみ保持され、ストレージへの保存や Finger Trader ウェブサイトサーバーへの送信は行いません。「リクエストを送信」を押した後、選択した API 環境に Authorization ヘッダーとして送信されます。完了後に消去してください。

CORS またはネットワークエラーが表示された場合、このウェブサイトからのリクエストが API 環境で許可されていない可能性があります。承認済みのサーバー側クライアントまたは API ツールを使用してください。ブラウザーのセキュリティを無効にしないでください。

Flutter アプリのログイン DTO、ログイン処理、API 環境設定、共通セッションヘッダー処理を照合しました。