× Note! You have entered LocalBitcoins.com through our user's affiliate program.

Σ

Price equations for Bitcoin advertisements

For most Bitcoin traders, adjusting the price of advertisements by setting a margin works well enough. But if you are a high volume trader the price equation feature allows you more control over your price. This guide explains the fundamentals on how you can use complex price equations to your advantage to beat the competition.

What is a price equation?

Price equations allow you to automatically update your price with the price fluctuations of Bitcoin. They work by taking price information that we automatically fetch from market data sources (Other Bitcoin exchanges) and updating the price of your advertisement as soon as new price information is fetched. To create a custom price equation you select your market data sources and combine or modify them using operators.

The default price equation we use for advertisements uses a special market data source called btc_in_usd and a simple multiplication operator to place a margin on top of the market data price.

The market data source btc_in_usd returns the median price from several different trusted exchanges. This means that even if one or many of the exchanges start giving erroneous information the price source will still give an accurate median price.

Advertisement prices are on average updated once every five minutes. When there is extra load on the service or if an API is slow to respond this process may take longer to run. The final price calculated from the price equation is for 1 BTC. Market data sources also always return the price for 1 BTC.

If the equation returns more than one value or no value, the equation is not valid and won't work. Market data sources may not always return a price if there is, for example, low to no recent volume in that market. If an equation is not valid or does not fully resolve the advertisement will be turned off automatically.

Make your own equation

Step 1: Choose your pricing sources

The first and most important part of your equation is the selection of market price source(s). You should carefully choose which exchange you base your price on, you can find a list of all available market sources at the end of this guide. A simple equation only uses one market data source, the below market source takes the 24 hour average price from the Bitcoin exchange Bitstamp:

bitstampusd_avg

This is already on it's own a working equation, but to make some profit selling Bitcoin you will want to modify this with an operator.

Step 2: Use operators to modify your equation

Operators are different mathematical functions that you can use to adjust and change your price equation to fit your own needs. You can see the operators that are supported in the table below.


Operator Example equation Example value Description
+ 1 + 1 2 Add two values together
- 5 - 1 4 Subtract the right value from the left one
* 2 * 5 10 Multiply two values
/ 5 / 2 2.5 Divide the left value by the right one
min min(25, 100)
25 Minimum gives returns the smaller of the two values inside the parenthesis. You can chain min() inside another to get the smallest value of multiple numbers. e.g.
min(min(25, 100), min(20, 300)) = 20
max max(25, 100)
100 Maximum gives returns the larger of the two values inside the parenthesis. You can chain max() inside another to get the largest value of multiple numbers. e.g.
max(max(25, 100), max(20, 300)) = 300


The simplest equation ads just a percentage markup on top of the market price. To add, for example, a 12% margin on top of the price you need to multiply the market price source by 1.12 to increase the price by 12%. The resulting equation looks like this:

bitstampusd_avg*1.12

If you buy your Bitcoin that you sell from two different exchanges, let's say Bitstamp and Bitfinex, you probably want to make sure that your Bitcoin price is based off of the exchange that has the higher price so that your margin stays correct. Using two market data sources has the added benefit of protecting you in case one exchange experiences a sudden price crash while the other doesn't.

To do this the max() operator is useful. It is used to choose the larger of two values given to it. To use the max() operator you enter two values separated by a comma into the parenthesis. The values entered can be a market data source or any number.

In our example we want to use the higher price of two different exchanges, Bitstamp and Bitfinex. First we search for their market data source name from the table below and then we add _avg after the market data source name to get the 24h average price. We then multiply the whole max() operator with 1.12 to add our margin:

max(bitstampusd_avg, bitfinexusd_avg)*1.12

This equation will first fetch pricing data from the two exchanges, Bitfinex and Bitstamp, and turn it into two numbers. The max() operator then selects the more expensive price of the two. Finally, it multiplies that price with 1.12 to get the final advertisement price.

Step 3: Convert the price to your own currency

If you're using a price source that is not in your own currency the final step is to convert it to the correct currency. For this, you can convert the price from USD to another currency using the USD_in_[currency] data source. For example, if I trade in Euros I would need to convert the example equation in the Step 2 from USD to EUR by multiplying the whole equation by USD_in_EUR. The resulting equation looks like this:

max(bitstampusd_avg, bitfinexusd_avg)*1.12*USD_in_EUR

You can find a list of all of the USD exchange rate sources further down on this page.

Test your equation

You can play around with your own equations using the field below. Choose which currency you trade in and enter any equation to see what the price would be.

Market price sources

We have hundreds of market data sources available to use in your price equations. Here is a table that lists all available market data sources. For most sources we fetch six different prices: high, low, bid, ask, close, and avg. We recommend you use the avg (average) price, the other price types have specific meaning and fluctuate often and can result in your price not being what you expect. Each market data source always gives the price for one whole Bitcoin, this table shows the current price returned from each market data source and price type.

In order to use the market price sources you need to take the data source name from the market column and add to it the price type.
For example, if you want to use the average bitfinexusd price you take the name of the market and add an underline and the text avg.

bitfinexusd_avg

high The highest price of completed trade during the last 24h.
low The lowest price of completed trade during the last 24h.
bid The bid price is the highest price that a buyer is willing to pay.
ask The ask price is the lowest price that a seller is willing to accept.
close The price of the latest completed trade.
avg The average price of completed trades for the last 24 hours.


Market high low bid ask close avg
okcoinusd 30,739.14 29,429.58 29,855.47 29,858.64 29,867.43
coinbaseusd 30,750.00 29,415.01 29,819.56
bitfinexusd 30,773.00 29,433.52 29,873.00 29,874.00 29,876.00 29,873.50
krakenusd 30,653.10 29,664.10 29,862.80 29,862.90 29,862.90 30,127.47
bitstampusd 30,753.96 29,400.00 29,860.65 29,875.14 29,868.95 30,173.52
krakeneur 29,030.70 28,176.50 28,374.90 28,381.30 28,381.30 28,641.59
geminiusd 29,877.36 29,877.37 29,877.37
coinbaseeur 29,320.54 27,941.71 28,359.21
bitstampeur 29,300.47 27,950.00 28,370.29 28,391.31 28,396.17 28,674.08
coinbasegbp 24,653.48 23,617.07 24,047.33
bitvavoeur 29,297.00 27,994.00 28,374.00 28,397.00 28,392.00

Altcoin market price

If you want to trade your bitcoins for altcoins we provide market sources that return the price for one whole Bitcoin in the other cryptocurrency. Below you can find a table that lists all available altcoin market data sources. We fetch three different prices: bid, ask, and close. This table shows the latest price returned from each market data source and price type.

In order to use the market price sources you need to take the data source name from the market column and add to it the price type.
For example, if you want to use the close poloniexeth price you take the name of the market and add an underline and the text close.

poloniexeth_close

bid The bid price is the highest price that a buyer is willing to pay.
ask The ask price is the lowest price that a seller is willing to accept.
close The price of the latest completed trade.


Market close bid ask
krakenada 53,078.55626327 53,050.39787798 53,022.26935313
bittrexeth 14.68809895 14.69763223 14.68787459
hitbtcslp 5,494,505.49450549 5,494,505.49450549 5,235,602.09424084
bittrexltc 419.28545373 419.5827669 418.61497051
poloniexxmr 174.21602787 174.85329808 174.1186549
bitfinexada 53,050.39787798 53,078.55626327 52,994.17064123
bitstampbch 146.71705909 146.69661234 146.31669664
krakeneth 14.70155837 14.70155837 14.69939732
bitfinexeth 14.69874914 14.69702091 14.69572501
bitfinexltc 419.23447784 419.18175721 418.93590281
krakendot 2,861.80350857 2,860.90290096 2,860.82105564
bittrexusdt 29,910.30199999 29,907.7531431 29,923.46657486
bittrexbch 146.51456501 146.62756598 146.32761583
bitfinexxmr 172.92660995 173.19916172 172.95951018
krakenxlm 216,450.21645022 216,450.21645022 215,982.72138229
bitfinexdot 2,861.47594929 2,863.93447318 2,861.55783208
bittrexdoge 336,700.33670034 337,837.83783784 336,700.33670034
krakenlink 3,990.74147977 3,988.67217103 3,985.65165405
krakenltc 419.46308725 419.28721174 418.93590281
krakenxrp 70,126.22720898 70,077.08479327 69,979.00629811
krakenbch 146.62756598 146.62756598 146.41288433
bitfinexdoge 0.00000033 0.00000034 0.00000033
poloniexdash 504.25337724 504.52559458 502.93209411
bitstamplink 3,994.88654522 3,993.13181328 3,983.9050237
bitfinexxrp 70,028.01120448 70,077.08479327 70,028.01120448
bittrexxvg 5,555,555.55555556 5,882,352.94117647 5,555,555.55555556
poloniexeth 14.6939133 14.69482234 14.68903101
poloniexltc 418.64826847 419.56692302 418.79203625
bitstampxrp 70,126.22720898 70,224.71910112 70,077.08479327
bittrexada 53,050.39787798 53,050.39787798 52,994.17064123
bitfinexdash 503.95605503 504.2610055 503.75295955
bittrexdot 2,859.10338518 2,864.67285436 2,858.36787195
bittrexxem 510,204.08163265 510,204.08163265 505,050.50505051
poloniexxem 507,614.21319797 507,614.21319797 505,050.50505051
krakendoge 336,700.33670034 337,837.83783784 336,700.33670034
krakendash 505.05050505 505.05050505 502.76520865
bittrexxlm 216,919.73969631 216,450.21645022 215,517.24137931
bittrexxrp 70,126.22720898 70,175.43859649 70,028.01120448
bitfinexxlm 215,982.72138229 216,450.21645022 215,982.72138229
krakenxmr 172.98045321 173.22016283 172.98045321
bittrexlink 4,006.7313086 3,992.81293671 3,983.9050237
poloniexxrp 70,077.08479327 70,077.08479327 70,028.01120448
hitbtcaxs 1,449.60940275 1,452.28095246 1,447.4545065
geminibch 0.00682 0.00679 0.00685
geminilink 0.00024966 0.00024987 0.00025149
bittrexusdc 29,664.78789677 29,931.15833583 29,832.93556086
geminieth 0.06805 0.06803 0.06805

USD exchange rates

You can get the exchange rate of 1 USD in other currencies using these data sources. To convert a price from USD simply multiply it with the correct USD_in data source. To convert other currencies into USD, get the inverse e.g. 1/USD_in_EUR and multiply it with your price.

Exchange rate data sources

Altcoin exchange rate data sources

Mobile app now available!
For Android and iOS devices
Get it on Google Play Download on the App Store