Elven Docs
简体中文
简体中文
  • 开始使用
  • 系统配置
    • 开始使用 Elven
    • 项目和主体
      • 选择会计起始日期
    • 邀请成员
    • 查看操作记录
  • 财务配置
    • 配置会计科目
      • 配置多级会计科目
      • 批量导入会计科目
    • 配置凭证模板
    • 配置辅助核算
    • 录入科目期初余额
  • 账户管理
    • 导入余额数据
    • 导入交易数据
      • 导入普通交易数据
      • 导入衍生品交易
    • 账户余额校验
    • 对手方账户管理
      • 对手方管理
      • 对手方识别规则管理
    • 添加交易所主/子账户
  • 交易管理
    • 交易总览
  • 记账
    • 通过交易数据记账
      • 给交易手动打标签
      • 通过规则进行自动打标签
    • 通过业务数据记账
      • 通过 API 导入业务数据
      • 通过 CSV 导入业务数据
      • 业务数据通过规则自动化记账
    • 记账凭证审核
  • 资产与估值
    • 资产管理
      • 如何通过智能合约地址添加 Token
      • 为资产自定义价格源
    • 加密资产公允价值与调账
      • Valuation 表介绍
    • 法币汇兑损益调账
    • 衍生品未实现损益调账
    • Broker 业务存货管理
  • 对账
    • 交易对账
  • 报告
    • 试算平衡表
    • 科目余额表
    • 财务报表
    • 加密资产披露表
    • 仪表盘
  • OpenApi
    • 接口授权
    • 在线接口调试
    • V3
      • 上传业务数据
      • 业务数据 source 查询接口
      • 删除业务数据 source 接口
      • 账户查询接口
      • 添加账户接口
      • 创建 source 接口
      • 账户 source 查询接口
      • 删除账户 source 接口
      • 资产查询接口
      • 批量添加资产接口
      • 币种查询接口
      • 平台查询接口
      • 导入价格接口
      • 导入账户余额接口
      • 导入转账记录接口
      • 导入交易记录接口
      • 导入损益记录接口
      • 添加对手方接口
    • V4
      • 导入价格接口
      • 导入账户余额接口
      • 导入转账记录接口
      • 导入交易记录接口
      • 导入损益记录接口
    • 时区信息
Powered by GitBook
On this page
  • 接口概述
  • 请求头参数
  • 请求参数
  • 注意事项

Was this helpful?

  1. OpenApi
  2. V4

导入损益记录接口

Previous导入交易记录接口Next时区信息

Last updated 2 months ago

Was this helpful?

接口概述

该接口用于批量导入损益记录到系统中,支持一次性导入多条损益记录数据。新增按照资产代码传递资产信息的能力。(原有 V3 版本接口,必须使用 Elven 系统的资产 id 来传递资产信息)

  • 请求方式:POST

  • 请求 URL:https://openapi.elven.com/open/v4/transaction/gainLoss

请求头参数

参数名
类型
必填
说明

elven-api-key

String

是

分配给您的API密钥

elven-api-sign

String

是

请求签名,用于验证请求合法性

elven-api-timestamp

String

是

请求时间戳,毫秒级

请求参数

Body 参数(JSON 格式)

参数名
类型
必填
说明

entityAccountId

String

是

账户的主键 ID

sourceId

String

是

Source 的主键 ID

timezone

String

否

list

Array

是

包含多条损益记录的数组(每次最多支持 5000 条记录)

list 数组元素

参数名
类型
必填
说明

datetime

String

是

交易时间,格式为 YYYY-MM-DD HH:mm:ss

gainLossID

String

否

损益记录唯一标识

type

String

是

损益交易类型

positionSide

String

否

合约持仓方向(枚举值:LONG/SHORT)。仅在 type 为 FUTURE_REALIZED 或 FUTURE_UNREALIZED 时必填

baseAssetSymbol

String

是

标的资产名称,最大 200 字符

gainLossAssetID

String

否

都填写时,只会识别gainLossAssetID

gainLossAssetSymbol

String

否

都填写时,只会识别gainLossAssetID

gainLossAmount

Number

是

收益(损失)金额

memo

String

否

备注信息

originalType

String

否

原始交易类型信息

type 参数说明

类型
说明

FUTURE_REALIZED

合约已实现收益(损失)

FUTURE_UNREALIZED

合约未实现收益(损失)

OPTIONS_REALIZED

期权已实现收益(损失)

OPTIONS_UNREALIZED

期权未实现收益(损失)

PositionSide 参数说明

type
positionSide 是否必填

FUTURE_REALIZED

必填(LONG/SHORT)

FUTURE_UNREALIZED

必填(LONG/SHORT)

OPTIONS_REALIZED

必须为空

OPTIONS_UNREALIZED

必须为空

请求示例

{  "entityAccountId": "w597WQZ5SzfKegoGB8qF1XRA2D39dr0U",
    "sourceId": "mKEd2CxfIvclgwCMqOpn8m9iYZ16Bde4",
    "timezone":"UTC",
    "list": [
        {
            "datetime": "2024-08-01 15:59:00",
            "gainLossID": "123458",
            "type": "FUTURE_UNREALIZED",
            "baseAssetSymbol":"ETHSOL-PERP1",
            "positionSide":"LONG",
            "gainLossAssetID":"",
            "gainLossAssetSymbol":"USDT",
            "gainLossAmount":700,
            "memo":"",
            "originalType":"8888"
        }
    ]
}

响应参数

参数名
类型
说明

status

String

请求状态(如 success)

data

Boolean

请求结果(如 true 表示成功)

响应示例

{
    "status": "success",
    "data": true,
    "requestId": "478ec893-2496-4823-8e04-0797fb06f687"
}

注意事项

  1. 异步处理:该接口调用成功后只是将数据导入到预处理数据库,系统需要一段时间来处理导入的损益记录数据,处理完成后才会显示在用户损益记录列表内。

  2. 记录数量限制:每次请求最多支持导入 5000 条损益记录。

  3. 数据完整性:请确保提供的交易数据完整且准确,避免因数据错误导致导入失败。

  4. 时间格式:datetime 参数的格式必须严格按照 YYYY-MM-DD HH:mm:ss,否则可能导致解析错误。

  5. 交易类型:type 参数必须选择正确的值,具体规则见上文。

时区,为空时视为 entity 时区。

收益(损失)计量的资产币种ID,需区分大小写,可从当前 entity 所支持的币种 gainLossAssetID 和gainLossAssetSymbol至少填写一个

收益(损失)计量的资产币种代码,需区分大小写,可从当前 entity 所支持的币种 gainLossAssetID 和gainLossAssetSymbol至少填写一个

查看详细说明
具体介绍
资产查询接口
资产查询接口