Customising price feeds for assets

Issues addressed

In Elven, asset prices are used for bookkeeping, fair value calculations, and other processes. By default, Elven uses prices from Coingecko for cryptocurrency assets and exchange rates from Exchangerates for fiat currency.

However, users can choose not to rely on Elven’s default price sources and opt to use other price data, such as price data exported from exchanges or separately maintained price information. These requirements can be fulfilled through the Custom Price Feed feature.

Steps

1. From the project homepage, navigate to the Valuation page.

2. Click on the Price tab to access the list of price feeds currently in use.

By default, Coingecko is the pricing source for Cryptocurency assets, and Exchangerates is the pricing source for fiat currencies in Elven.

Creating a new price feed

Click the "+ Add New" button in the upper right corner of the Price page, and fill in the fields of the pop-up window:

Compulsory fields:

1. Price feed name

2. Price retrieval method:

   1. CSV: manually upload a CSV file with pricing details

   2. API (coming soon)

3. Timezone: specific timezone that the price feed is based on.

4. Quote: the quoted currency of the feed.

Once you have filled in the necessary information, click "Add" to finish creating the new price feed. You will see the newly added price feed in the list of price feeds.

Adding Pricing data

For CSV method, the next step is to upload the prepared price file into the new price feed created.

Click on the newly added price feed, and in the details panel pop-out on the right, click "+ Add data"

Upload the prepared pricing data into the pop-up upload window.

You can download a sample template to help with preparing the pricing data. The standard pricing data format looks like this:

Assets	Datetime	Price
BTC	2024/07/18 16:37:00	64696.79
ETH	2024/07/18 16:37:00	3182.73

Column description:

1. Assets: the Asset code, e.g. BTC, ETH, etc.

2. Datetime: the timestamp of the pricing feed, in the format YYYY/MM/DD HH:MM:SS

3. Price: The pricing value, in numeric format.

If your uploaded file contains unrecognized rows, the fields in those rows would need to be corrected and re-uploaded.

Once the pricing data is successfully uploaded, you can start using this price feed.

Selecting price feed for an Asset

On the Valuation page, navigate to the Assets section to access the asset management interface. Here you can see the assets that have already been added or synced for the entity.

Locate the asset that you'd like to manage, if it doesn't exist, try adding it manually.

Click on the asset you want to manage, a sliding panel will come out on the right side, and select the target price feed.

Please note that once the seleted price feed contains the asset you are managing, the price information will be applied, and you will no longer be ble to change the price feed. Please proceed with caution.