盈虧分析明細

獲取指定證券的詳細盈虧分析，包含交易流水和成本分解。

CLI

longbridge profit-analysis detail TSLA.US
longbridge profit-analysis detail AAPL.US

SDK Links

Python	longbridge.openapi.PortfolioContext.profit_analysis_detail
Rust	longbridge::portfolio::PortfolioContext#profit_analysis_detail
Go	PortfolioContext.ProfitAnalysisDetail
Node.js	PortfolioContext#profitAnalysisDetail
Java	PortfolioContext.getProfitAnalysisDetail
C++	longbridge::portfolio::PortfolioContext::profit_analysis_detail

Parameters

SDK 方法參數。

Name	Type	Required	Description
symbol	string	是	證券代碼，例如 AAPL.US
start	string	否	開始日期，格式 YYYY-MM-DD
end	string	否	結束日期，格式 YYYY-MM-DD

Request Example

from longbridge.openapi import PortfolioContext, Config, OAuthBuilder

oauth = OAuthBuilder("your-client-id").build(lambda url: print("Visit:", url))
config = Config.from_oauth(oauth)
ctx = PortfolioContext(config)

resp = ctx.profit_analysis_detail("TSLA.US")
print(resp)

import asyncio
from longbridge.openapi import AsyncPortfolioContext, Config, OAuthBuilder

async def main() -> None:
    oauth = await OAuthBuilder("your-client-id").build_async(lambda url: print("Visit:", url))
    config = Config.from_oauth(oauth)
    ctx = AsyncPortfolioContext.create(config)

    resp = await ctx.profit_analysis_detail("TSLA.US")
    print(resp)

if __name__ == "__main__":
    asyncio.run(main())

const { Config, PortfolioContext, OAuth } = require('longbridge')

async function main() {
  const oauth = await OAuth.build('your-client-id', (_, url) => {
    console.log('Open this URL to authorize: ' + url)
  })
  const config = Config.fromOAuth(oauth)
  const ctx = PortfolioContext.new(config)
  const resp = await ctx.profit_analysis_detail()
  console.log(resp)
}
main().catch(console.error)

import com.longbridge.*;
import com.longbridge.portfolio.*;

class Main {
    public static void main(String[] args) throws Exception {
        try (OAuth oauth = new OAuthBuilder("your-client-id").build(url -> System.out.println("Open to authorize: " + url)).get();
             Config config = Config.fromOAuth(oauth);
             PortfolioContext ctx = PortfolioContext.create(config)) {
            var resp = ctx.getProfitAnalysisDetail().get();
            System.out.println(resp);
        }
    }
}

use std::sync::Arc;
use longbridge::{oauth::OAuthBuilder, portfolio::PortfolioContext, Config};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let oauth = OAuthBuilder::new("your-client-id").build(|url| println!("Open: {url}")).await?;
    let config = Arc::new(Config::from_oauth(oauth));
    let ctx = PortfolioContext::new(config);
    let resp = ctx.profit_analysis_detail().await?;
    println!("{:?}", resp);
    Ok(())
}

#include <iostream>
#include <longbridge.hpp>

using namespace longbridge;
using namespace longbridge::portfolio;

int main() {
    OAuthBuilder("your-client-id").build(
        [](const std::string& url) { std::cout << "Open: " << url << std::endl; },
        [](auto res) {
            if (!res) return;
            Config config = Config::from_oauth(*res);
            PortfolioContext ctx = PortfolioContext::create(config);
            ctx.profit_analysis_detail([](auto resp) {
                if (resp) std::cout << "OK" << std::endl;
            });
        });
    std::cin.get();
}

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/longbridge/openapi-go/config"
	"github.com/longbridge/openapi-go/oauth"
	"github.com/longbridge/openapi-go/portfolio"
)

func main() {
	o := oauth.New("your-client-id").
		OnOpenURL(func(url string) { fmt.Println("Open this URL to authorize:", url) })
	if err := o.Build(context.Background()); err != nil {
		log.Fatal(err)
	}
	conf, err := config.New(config.WithOAuthClient(o))
	if err != nil {
		log.Fatal(err)
	}
	c, err := portfolio.NewFromCfg(conf)
	if err != nil {
		log.Fatal(err)
	}
	defer c.Close()
	resp, err := c.ProfitAnalysisDetail(context.Background())
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", resp)
}

Response

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "name": "Apple",
    "currency": "USD",
    "profit": "100.00",
    "start": "1763769600",
    "end": "1778724973",
    "start_date": "2025-11-22",
    "end_date": "2026-05-14",
    "default_tag": 0,
    "updated_at": "1778724973",
    "updated_date": "2026-05-14",
    "underlying_details": {
      "profit": "100.00",
      "holding_value": "1790.16",
      "holding_value_at_beginning": null,
      "holding_value_at_ending": "1790.16",
      "long_holding_value": "1790.16",
      "short_holding_value": "0.00",
      "cumulative_credited_amount": "0.00",
      "cumulative_debited_amount": "0.00",
      "cumulative_fee_amount": "0.00",
      "credited_details": [],
      "debited_details": [],
      "fee_details": []
    },
    "derivative_pnl_details": {
      "profit": "0.00",
      "holding_value": "0.00",
      "holding_value_at_beginning": null,
      "holding_value_at_ending": "0.00",
      "long_holding_value": "0.00",
      "short_holding_value": "0.00",
      "cumulative_credited_amount": "0.00",
      "cumulative_debited_amount": "0.00",
      "cumulative_fee_amount": "0.00",
      "credited_details": [],
      "debited_details": [],
      "fee_details": []
    }
  }
}

Response Status

Status	Description	Schema
200	成功	ProfitAnalysisDetailResponse
400	請求錯誤	None

Schemas

ProfitAnalysisDetailResponse

Name	Type	Required	Description
name	string	false	證券名稱
currency	string	false	貨幣
profit	string	false	總盈虧
start	integer	false	統計期開始
end	integer	false	統計期結束
start_date	string	false	開始日期
end_date	string	false	結束日期
default_tag	integer	false	默認顯示標簽
underlying_details	object	false	正股盈虧明細
updated_at	string	false	最後更新時間
updated_date	string	false	最後更新日期
derivative_pnl_details	object	false	衍生品盈虧明細

ProfitDetails

Name	Type	Required	Description
profit	string	false	總盈虧
holding_value	string	false	當前持倉市值
holding_value_at_beginning	string	false	期初持倉市值
holding_value_at_ending	string	false	期末持倉市值
long_holding_value	string	false	多頭持倉市值
short_holding_value	string	false	空頭持倉市值
cumulative_credited_amount	string	false	累計入賬金額
cumulative_debited_amount	string	false	累計出賬金額
cumulative_fee_amount	string	false	累計費用金額
credited_details	object[]	false	入賬明細
debited_details	object[]	false	出賬明細
fee_details	object[]	false	費用明細