Developer onboarding
Getting Started with Finger Trader APIs
Start here before exploring any product documentation. Confirm account access, sign in to obtain an access token, then send it with authenticated API requests.
Before you make an API request
Finger Trader APIs use your account session to identify the caller. Complete the account prerequisites and sign in before calling authenticated business endpoints.
Account prerequisites
- Your Finger Trader account must be activated.
- You must have opened an account with a broker in the Finger ecosystem.
1. Sign in and obtain an access token
The app requests an OAuth 2.0 access token from the authentication service using the password grant. Email sign-in uses type 1; mobile sign-in uses type 2. Include captchaId and captchaCode only when the service requests a captcha.
POST https://prod-api.fingertrader.com/finger-auth/oauth2/tokenAuthorization: Basic <APP_CLIENT_CREDENTIALS>
Content-Type: application/x-www-form-urlencodedgrant_type=password
username=<EMAIL_OR_PHONE>
password=<PASSWORD>
type=1 # email; use 2 for mobileThe Flutter app supplies its configured client credential. It is intentionally not included in this public documentation or browser-based Try it tool.
{
"code": 0,
"data": {
"access_token": "<ACCESS_TOKEN>",
"refresh_token": "<REFRESH_TOKEN>",
"token_type": "Bearer",
"expires_in": 0
},
"msg": ""
}2. Send the access token in the request header
Use the access_token returned by sign-in. The token_type returned by the service is Bearer in the app flow. Do not send the refresh token to business endpoints.
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json3. Call the Finger Trader BFF API
The Flutter app sends business requests to the BFF API base URL, uses JSON request bodies, and adds the session Authorization header when signed in. API paths shown here follow the app client implementation.
https://prod-api.fingertrader.com/finger-bff-appcurl --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": ""
}Try an API request
Enter an Access Token and a POST path under /app-api/v1. The browser sends this request directly to the selected official Finger Trader API environment.
Ready. Nothing is sent until you select Send request.
The response will appear here.The token stays in this page’s memory and is not saved to storage or sent to Finger Trader website servers. It is sent in the Authorization header to the API environment you select, only after you click Send request. Clear it when finished.
If the browser reports a CORS/network error, the API environment may not allow requests from this website origin. Use the same request from your approved server-side client or API tool; do not disable browser security.
Verified against the Finger Trader Flutter app authentication DTO, login flow, API configuration, and shared session header interceptor.