导入转账记录接口

接口概述

该接口用于批量导入转账记录(Transfer)到系统中，支持一次性导入多条数据。

• 请求方式：POST

• 请求 URL：https://openapi.elven.com/open/v3/transaction/transfer

请求头参数

参数名	类型	必填	说明
elven-api-key	String	是	分配给您的API密钥
elven-api-sign	String	是	请求签名，用于验证请求合法性
elven-api-timestamp	String	是	请求时间戳，毫秒级

查看详细说明

请求参数

Body 参数（JSON 格式）

参数名	类型	必填	说明
entityAccountId	String	是	账户的主键 ID
sourceId	String	是	Source 的主键 ID
timezone	String	否	时区，为空时视为 entity 时区。具体介绍
list	Array	是	转账记录列表，包含多个对象，每次最多支持 1000 条记录

list 数组元素

参数名	类型	必填	说明
direction	String	是	交易方向，IN（收入）或 OUT（支出）
amount	Number	是	交易金额
currency	String	是	交易币种，可从币种查询接口获取 区分大小写
transactionID	String	否	交易哈希或唯一标识
type	String	是	交易类型，根据平台类型（platform.type）进行区分，详见下方说明
datetime	String	是	交易时间，格式为 YYYY-MM-DD HH:mm:ss
counterpartyAccountNo	String	否	对手方的地址或账号
counterpartyPlatformId	String	否	对手方的平台 ID
memo	String	否	备注信息

type 参数说明

• 当 platform.type 为 CHAIN，type 可选值：

  • CHAIN_TRANSFER_IN

  • CHAIN_TRANSFER_OUT

  • CHAIN_TRANSACTION_FEE

• 当 platform.type 为 BANK，type 可选值：

  • BANK_DEPOSIT

  • BANK_WITHDRAW

  • BANK_FEE

  • BANK_INCOMING_FX

  • BANK_OUTGOING_FX

• 当 platform.type 为 EXCHANGE，type 可选值：

  • EXCHANGE_DEPOSIT

  • EXCHANGE_WITHDRAW

  • EXCHANGE_TRADE_IN

  • EXCHANGE_TRADE_OUT

  • EXCHANGE_FEE

  • EXCHANGE_STAKE

  • EXCHANGE_UNSTAKE

  • EXCHANGE_REWARD

  • EXCHANGE_REALIZED_PNL

  • EXCHANGE_BORROW

  • EXCHANGE_REPAY

  • EXCHANGE_FUNDING_FEE

  • EXCHANGE_TRANSFER_IN

  • EXCHANGE_TRANSFER_OUT

• 当 platform.type 为 CUSTODY，type 可选值：

  • CUSTODY_DEPOSIT

  • CUSTODY_WITHDRAW

  • CUSTODY_FEE

• 当 platform.type 为 PAYMENT，type 可选值：

  • PAYMENT_COMPLETED

  • PAYMENT_CHARGE_BACK

  • PAYMENT_REFUND

  • PAYMENT_FEE

  • PAYMENT_PAYOUT

  • PAYMENT_INCOMING_FX

  • PAYMENT_OUTGOING_FX

请求示例

{
    "entityAccountId": "accountId123",
    "sourceId": "sourceId456",
    "list": [
        {
            "direction": "IN",
            "amount": 10,
            "currency": "BTC",
            "transactionID": "0xaaa",
            "type": "CHAIN_TRANSFER_IN",
            "datetime": "2024-01-01 01:11:11",
            "counterpartyAccountNo": "0xsss",
            "counterpartyPlatformId": "platformId789",
            "memo": "交易备注"
        },
        {
            "direction": "OUT",
            "amount": 5,
            "currency": "ETH",
            "transactionID": "0xbbb",
            "type": "CHAIN_TRANSFER_OUT",
            "datetime": "2024-01-02 02:22:22",
            "counterpartyAccountNo": "0xttt",
            "counterpartyPlatformId": "platformId012",
            "memo": "另一笔交易备注"
        }
    ]
}

响应参数

参数名	类型	说明
status	String	请求状态（如 success）
data	Boolean	请求结果（如 true 表示成功）

响应示例

{
    "status": "success",
    "data": true
}

注意事项

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

2. 记录数量限制：每次请求最多支持导入 5000 条交易记录。

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

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

5. 时区说明：数据导入时，如果未提供时区字段。时区将和 Entity 设置的时区保持一致。

6. 交易类型：type 参数必须根据对应的 platform.type 选择正确的值，否则可能导致交易分类错误。