Import Price

API Overview

This API enables the batch import of price records into the system, supporting the import of multiple data entries in a single request.

• Request Method：POST

• Request URL：https://openapi.elven.com/open/v3/transaction/price

Request Headers

Parameter Name	Type	Required	Description
elven-api-key	String	Yes	The API key assigned to you
elven-api-sign	String	Yes	Request signature, used to verify the legitimacy of the request
elven-api-timestamp	String	Yes	Request timestamp, in milliseconds

View Details

Request Parameters

Body Parameters (JSON Format)

Parameter Name	Type	Required	Description
priceProviderId	String	Yes	The primary key ID of the price source.
list	Array	Yes	An array containing multiple price records (up to 5000 records per request).

Elements in the List

Parameter Name	Type	Required	Description
asset	String	Yes	The currency, case-sensitive. Supported currencies can be obtained from the currency inquiry API.
datetime	String	Yes	The time, in the format YYYY-MM-DD HH:mm:ss.
price	Number	Yes	The price.

Example Request

{
    "priceProviderId": "priceProviderId91",
    "list": [
        {
            "asset": "BTC",
            "datetime": "2024-11-18 00:00:00",
            "price": 10
        },
        {
            "asset": "ETH",
            "datetime": "2024-11-18 01:00:00",
            "price": 2000
        }
    ]
}

Response Parameters

Parameter Name	Type	Description
success	String	Request status (e.g., success).
data	Boolean	Request result (e.g., true indicates success).

Example Response

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

Notes

• Record Limit: Each request supports importing up to 5,000 price records.

• Time Format: The datetime parameter must strictly follow the YYYY-MM-DD HH:mm:ss format; otherwise, it may cause parsing errors.

• Case Sensitivity for Currencies: The asset parameter must match the standards returned by the currency query API, and it is case-sensitive.

• Time Zone Instructions: The timestamps of price records will be processed according to the system's configured time zone. If there are time zone differences, please adjust the data before importing.

• Data Integrity: Ensure that each price record is complete and accurate to avoid import failures caused by invalid data.

• Price Precision: The precision of the price parameter should align with actual business requirements and must not exceed the system's supported range.