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, 휴대전화 로그인 type은 2입니다. 서비스가 CAPTCHA를 요청할 때만 captchaId와 captchaCode를 포함하세요.

운영 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 앱은 JSON 업무 요청을 BFF API Base URL로 보내며 로그인 상태에서는 세션 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 환경 설정 및 공통 세션 헤더 인터셉터를 확인했습니다.