导入转账记录接口

接口概述

该接口用于批量导入转账记录(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
}

注意事项

异步处理：该接口调用成功后只是将数据导入到预处理数据库，系统需要一段时间来处理导入的数据，处理完成后才会显示在转账记录列表内。
记录数量限制：每次请求最多支持导入 5000 条交易记录。
数据完整性：请确保提供的数据完整且准确，避免因数据错误导致导入失败。
时间格式：datetime 参数的格式必须严格按照 YYYY-MM-DD HH:mm:ss，否则可能导致解析错误。。
时区说明：数据导入时，如果未提供时区字段。时区将和 Entity 设置的时区保持一致。
交易类型：type 参数必须根据对应的 platform.type 选择正确的值，否则可能导致交易分类错误。

Previous查询 source 接口 Next导入交易记录接口

Last updated 1 month ago