登入¶

登入必須擁有口袋帳戶。若還沒有帳戶，可詳見口袋開戶。

登入¶

PythonC#

api_key 是簽署文件後取得的 API 金鑰。password 是使用者密碼。fetch_contract 預設為 True，登入時會下載商品檔。contracts_timeout 預設為 0。

import pocketx as pk

api = pk.Pocket()
accounts = api.login(
    api_key="YOUR_API_KEY",
    password="YOUR_PASSWORD",
)
print(accounts)

登入成功會印出登入訊息，並回傳帳號列表。同時設定預設證券帳號 api.stock_account、預設期貨帳號 api.futopt_account。fetch_contract 為 True 時，還會印出商品檔下載結果。

=========================================== User Logged in ===========================================

Spend 0:00:00.598719 !!!!!!!!!!!!!!!!!!!!!!!!
Contracts status: Fetched
[StockAccount(person_id='YOUR_PERSON_ID', broker_id='6620', account_id='YOUR_STOCK_ACCOUNT_ID', signed=True, username='USERNAME', nanoid='YOUR_NANOID'),
 FutureAccount(person_id='YOUR_PERSON_ID', broker_id='6620', account_id='YOUR_FUT_ACCOUNT_ID', signed=True, username='USERNAME', nanoid='YOUR_NANOID')]

using PocketxSDK;

var pocketx = new Pocketx();
var _accounts = pocketx.Login("YOUR_API_KEY", "YOUR_SECRET_KEY");
var flag = pocketx.ca_activate("<你的pfx路徑>", "<你的 personal_id>", "<你的 personal_id>");
Console.WriteLine(_accounts);

[2025-xx-xx 13:59:21][INF][SYSTEM] Welcome to Pocketx!!!
[2025-xx-xx 13:59:21][INF][SYSTEM] Login...
[2025-xx-xx 13:59:22][INF][SYSTEM] Connecting to PulsarService...
[2025-xx-xx 13:59:22][INF][SYSTEM] Connected to PulsarService Successfully !!!

帳號¶

PythonC#

accounts = api.list_accounts()
print(accounts)
print(api.stock_account)
print(api.futopt_account)

api.set_default_account(accounts[0])
print(api.stock_account)
print(api.futopt_account)

list_accounts() 回傳這次登入的帳號。stock_account 是預設證券帳號，futopt_account 是預設期貨帳號。set_default_account() 依傳入帳號的類型，改寫對應的預設帳號。

[StockAccount(person_id='YOUR_PERSON_ID', broker_id='6620', account_id='YOUR_STOCK_ACCOUNT_ID', signed=True, username='USERNAME', nanoid='YOUR_NANOID'),
 FutureAccount(person_id='YOUR_PERSON_ID', broker_id='6620', account_id='YOUR_FUT_ACCOUNT_ID', signed=True, username='USERNAME', nanoid='YOUR_NANOID')]

StockAccount(person_id='YOUR_PERSON_ID', broker_id='6620', account_id='YOUR_STOCK_ACCOUNT_ID', signed=True, username='USERNAME', nanoid='YOUR_NANOID')

FutureAccount(person_id='YOUR_PERSON_ID', broker_id='6620', account_id='YOUR_FUT_ACCOUNT_ID', signed=True, username='USERNAME', nanoid='YOUR_NANOID')

using PocketxSDK;

var pocketx = new Pocketx();
var _accounts = pocketx.Login("YOUR_API_KEY", "YOUR_SECRET_KEY");
Console.WriteLine($"_accounts: {_accounts}");

using PocketxSDK;

var pocketx = new Pocketx();
var listAccounts = ListAccounts(pocketx);
Console.WriteLine(listAccounts);

listAccounts: [
    {"account_type":"...","person_id":"...","broker_id":"...","account_id":"...","signed":true,"username":"..."}
]

登出¶

PythonC#

api.logout()

=========================================== User Logged out ===========================================

using PocketxSDK;

var pocketx = new Pocketx();
var res = _api.Logout();
Console.WriteLine(res);