Skip to main content
POST
/
fapi
/
v1
/
profitHistorical
Profit And Loss Records
curl --request POST \
  --url https://futuresopenapi.odyssey.trade/fapi/v1/profitHistorical \
  --header 'Content-Type: application/json' \
  --header 'x-ch-apikey: <x-ch-apikey>' \
  --header 'x-ch-sign: <x-ch-sign>' \
  --header 'x-ch-ts: <x-ch-ts>' \
  --data '{
  "contract_name": "<string>",
  "limit": 100,
  "from_id": 123
}'
[
  {
    "side": "BUY",
    "position_type": 1,
    "trade_fee": "<string>",
    "realized_amount": "<string>",
    "leverage_level": 123,
    "open_price": "<string>",
    "settle_profit": "<string>",
    "mtime": 123,
    "share_amount": "<string>",
    "open_end_price": "<string>",
    "close_profit": "<string>",
    "volume": "<string>",
    "contract_id": 123,
    "history_realized_amount": "<string>",
    "ctime": 123,
    "id": 123,
    "capital_fee": "<string>"
  }
]

Headers

​
x-ch-sign
string
required

Request signature.

​
x-ch-apikey
string
required

The user's API key.

​
x-ch-ts
string
required

The current time in milliseconds.

Body

application/json

Receives data on the historical profits and losses.

Source: https://exchangeopenapi.gitbook.io/pri-openapi/openapi-doc/futures-trading-api#profit-and-loss-record

​
contract_name
string
required
​
limit
integer
default:100
​
from_id
integer | null

Response

Successful Response

​
side
enum<string>
required
Available options:
BUY,
SELL
​
position_type
enum<integer>
required
Available options:
1,
2
​
trade_fee
string
required
​
realized_amount
string
required
​
leverage_level
integer
required
​
open_price
string
required
​
mtime
integer
required
​
share_amount
string
required
​
open_end_price
string
required
​
close_profit
string
required
​
volume
string
required
​
contract_id
integer
required
​
history_realized_amount
string
required
​
ctime
integer
required
​
id
integer
required
​
capital_fee
string
required
​
settle_profit
string | null