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
Operator
Example equation
Example value
Description
^
5 ^ 2
25
Exponent - left value raised to the power of right
sin, cos, tan
sin(pi/2)
1
Trigonometric operators. Use radians for input. The constant pi is available to create neat radian values.
abs
abs(-5)
5
Absolute value. Turns negative values into positive and positive values remain positive.
trunc
trunc(5.9)
trunc(-5.9)
5
-5
Truncation drops any decimals without rounding.
ceil
ceil(5.9)
ceil(-5.9)
6
-5
Ceiling picks the smallest whole number that is larger or equal than the value.
floor
floor(5.9)
floor(-5.9)
5
-6
Floor picks the largest whole number that is smaller or equal than the value.
round
round(5.9)
round(-5.4)
6
-5
Rounding rounds to closest number, dropping decimals.
sgn
sgn(-5)
sgn(5)
-1
1
Gives the sign of the value. Possible values are 1, 0, -1.
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:
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
coinbaseusd
63,612.27
58,862.85
63,500.00
krakenusd
63,589.10
62,550.40
63,489.90
63,490.00
63,489.90
62,075.32
bitstampusd
63,576.00
58,863.00
63,500.00
63,509.00
63,511.00
61,864.00
bitfinexusd
63,681.00
58,914.00
63,616.00
63,617.00
63,616.00
63,616.50
bitvavoeur
59,117.00
54,826.00
59,027.00
59,035.00
59,025.00
geminiusd
63,493.68
63,493.69
63,493.69
krakeneur
59,055.30
58,174.40
58,978.30
58,978.40
58,978.30
57,275.15
coinbaseeur
59,123.07
54,811.98
59,017.27
Market
high
low
bid
ask
close
avg
bitstampeur
59,999.00
54,813.00
58,998.00
59,005.00
59,006.00
57,536.00
coinbasegbp
50,700.00
46,889.46
50,533.34
maicointwd
2,073,469.30
1,926,423.80
2,073,029.70
2,072,295.50
2,072,295.50
btcmarketsaud
96,373.76
89,700.00
96,100.21
96,292.13
96,300.46
93,367.93
bitfinexeur
59,095.00
54,830.00
58,990.00
59,010.00
58,974.00
59,000.00
zaifjpy
9,737,330.00
9,059,015.00
9,720,000.00
9,729,760.00
9,725,000.00
9,538,071.75
btcboxjpy
9,747,124.00
9,091,111.00
9,732,883.00
9,760,000.00
9,684,866.00
9,661,811.64
cexusd
63,100.00
59,000.00
63,419.70
63,496.90
63,000.00
62,528.26
cexiousd
63,100.00
59,000.00
61,585.00
63,500.00
63,000.00
cexeur
58,000.00
56,500.00
57,000.10
59,000.00
58,000.00
57,290.21
cexioeur
58,000.00
56,500.00
58,711.40
59,000.00
58,000.00
coinfalconeur
32,000.01
32,000.01
32,000.01
39,999.99
32,000.01
32,000.01
krakenxrp
103,600.64
104,931.79
103,842.16
ruxumthb
135.00
bcmmbusd
10.00
exmorub
47,468.00
47,620.00
47,435.00
weexcad
150.00
120.00
bceur
64,777.01
65,295.46
65,798.00
crytrusd
243.00
265.00
625.00
btceureur
357.70
403.82
255.00
ibwtusd
1,200.00
500.00
ruxumpln
13.50
btcncny
28,158.00
28,399.99
28,158.00
ripplexrp
71,364.47
71,467.41
69,707.31
mtgoxhkd
1,021.53
1,074.57
1,001.00
coinsbankusd
42,000.00
98,000.00
98,000.00
bitalousd
9,100.00
600.00
bitflyerusd
15,556.60
15,618.70
15,635.47
bitkonanusd
19,007.90
24,999.00
19,008.00
bitnznzd
1,200.00
2,000.00
2,000.00
wbxaud
26.00
26.00
btcexyad
132.00
ruxumsgd
5.20
krakennmc
1,186.11
1,271.46
1,271.46
itbitsgd
5,040.50
27,068.06
4,867.00
globalpln
15.82
mtgoxeur
95.89
98.41
95.89
bcmppusd
23.50
coinflooreur
41,178.00
41,269.00
41,317.00
rockeur
22,922.72
22,930.86
22,930.86
korbitkrw
45,598,000.00
45,683,000.00
45,660,000.00
ruxumzar
25.00
coinsbankeur
16,000.00
100,000.00
15,000.00
intrsngeur
316.54
419.00
308.01
krakenltc
161.34
162.07
160.56
btc24usd
73.00
anxhkhkd
2,857.96
2,919.43
1,907.34
thlrusd
4.35
lybitcad
104.97
chbtccny
27,028.19
28,000.00
27,197.00
wexrub
477,333.72
515,451.29
515,642.84
freshpln
25.00
mtgoxsgd
166.98
175.65
200.00
bitmeusd
86.00
vbtcvnd
395,000,000.00
440,000,000.00
440,000,000.00
vcxusd
1,501.00
10,000.00
6,500.00
btc24eur
412.00
503.00
412.00
bitsomxn
187,000.99
188,000.00
5,200.00
ruxumchf
3.00
coinsbitiousd
43,003.67
43,072.52
43,035.13
bcmlrusd
11.00
mtgoxaud
146.44
154.04
144.30
foxbitbrl
24,666.03
25,199.99
24,664.04
ruxumeur
5.00
ibwteur
10,000.00
1.00
fbtceur
125.00
mtgoxsek
857.00
901.50
1,046.41
urdubitpkr
24,000.00
8,489,427.00
mtgoxnzd
158.78
167.02
151.00
p2pb2busd
11,239.48
11,338.00
11,258.45
thclp
3,050.00
kptnsek
3,200.00
3,468.47
3,468.47
anxhkaud
512.20
541.93
333.85
bitchangepln
10.00
rippleeur
265.00
258.00
anxhksgd
514.29
544.96
341.73
ruxumaud
4.25
anxhkcny
2,430.00
2,578.25
1,553.74
bcmpxgau
0.20
mrcdbrl
330,158.00
330,751.00
330,158.00
snwcnxrp
8,999.00
bitmeltc
27.00
67.76
justxrp
25,000.00
74,998.00
64,001.00
bitpayusd
62,827.93
bitpayjpy
9,616,757.78
btchkexhkd
572.00
btcexusd
6.80
fybsgsgd
15,000.00
49,000.00
4,700.00
bitomatpln
29.20
lybitusd
119.00
fluctopln
37,217.30
26,021.26
ruxumhuf
79.00
cryptoniteur
5,678.10
8,200.00
6,800.00
globaleur
4.00
b7usd
4.75
bitaloeur
6,900.00
306.00
200.00
bitflyerjpy
3,772,576.00
3,774,720.00
3,755,740.00
wexusd
7,900.01
8,180.00
7,900.01
ruxumsek
20.00
remitanovnd
978,584,310.00
929,105,492.56
153,045,823.05
fbtcusd
165.00
intrsngpln
335.00
bitxngn
23,812,057.00
24,080,948.00
55,480,005.00
bitalopln
1,700.00
1,950.00
btcxchangeron
1,155.36
1,169.07
1,800.00
weexusd
395.00
395.00
hitbtcusd
7,906.62
7,910.00
7,915.48
thinr
318.00
abucoinsusd
0.61
8,210.51
8,210.51
bitcurexusd
615.03
642.84
629.15
bitpayeur
58,370.40
btcdeeur
9,173.00
9,219.89
9,282.49
btctradecny
22,020.10
22,199.00
24,821.00
krakenjpy
6,327,212.00
6,350,550.00
6,339,800.00
bitmarketeur
7,450.87
7,625.70
7,450.85
coinsbankgbp
72,066.00
27,617.99
btcexrub
199.00
bitmaszynapln
2,000.00
100,000.00
100,000.00
bitfloorusd
100.00
anxhkcad
506.84
536.04
317.09
intrsnggbp
271.40
376.18
376.18
omnitradebrl
33,000.00
34,500.00
34,500.00
allcoinusd
16,500.00
17,350.00
16,500.00
vcxeur
726.00
6,400.00
6,400.00
bitcurexpln
1,227.50
1,240.00
2,289.00
krakenkrw
495,000.00
545,000.00
525,142.00
bitbayusd
42,000.00
42,500.00
42,500.00
bitcurexeur
569.99
595.86
573.00
anxhknzd
555.72
588.51
371.29
b2cusd
6.50
anxhkjpy
41,227.18
49,140.39
29,436.15
globalgbp
2.99
rocksll
18,050.00
exchbusd
3.64
cryptoxaud
22.00
bitpaychf
56,853.37
btcoididr
315,279,000.00
315,280,000.00
315,279,000.00
bitxidr
600,001,000.00
602,989,000.00
660,000,000.00
ibwtltc
300.00
1.00
crytreur
210.00
298.00
481.12
imcexeur
7.71
ibwtgbp
950.00
287.00
bitbayeur
37,201.55
37,415.00
37,307.30
bitstockczk
115,901.00
124,146.00
121,796.00
ruxumrub
195.00
ruxumjpy
210.00
krakencad
58,841.10
58,886.80
58,862.50
mtgoxcny
803.10
844.80
784.38
bidxtrmpln
1,751.00
mtgoxrub
4,683.29
4,926.43
5,899.99
bitcashczk
6,700.00
jubicny
27,150.00
27,599.00
27,599.00
coinfloorgbp
35,262.00
35,319.00
35,290.00
krakengbp
2,990.00
3,240.00
3,018.00
bitmarketusd
14.00
bitpaycny
454,704.61
bitmarketaud
14.00
abucoinspln
29,246.93
29,450.00
29,450.00
cryptoxusd
13.35
btcexwmr
155.00
justnok
1,100.00
2,298.00
2,058.00
bit121gbp
300.00
300.00
cotrusd
411.40
473.99
391.98
mtgoxthb
4,017.41
4,830.52
3,500.00
nevbitpln
1,341.00
1,440.99
166,637.47
ruxumusd
14.75
btcalphausd
148,674.74
0.00
9,800.00
cbxusd
11.00
9,000.00
10,000.00
wexeur
7,011.81
7,500.00
7,500.00
1coinusd
222.80
223.00
253.80
bitmarketrub
300.00
zyadoeur
4,833.47
4,839.01
4,839.01
hitbtceur
2,501.31
4,499.99
4,499.99
mtgoxpln
484.87
517.15
403.06
imcexusd
20.00
mtgoxcad
146.17
153.76
120.01
virtexcad
548.00
550.00
550.00
ruxumhkd
29.00
intrsngusd
11.90
btcexeur
3.90
btccusd
6,651.13
6,899.76
6,700.00
cexrub
3,245,844.70
3,476,934.70
3,476,934.70
btcexjpy
1.00
bitxzar
651,491.00
651,863.00
660,454.00
bitpayaud
95,121.81
bitalogbp
1,896,343.19
340.00
bbmbrl
18.00
bitbaypln
170,290.84
170,897.99
170,897.75
btc2ubrl
654.50
659.99
654.50
britcoingbp
3.66
bitmarketgbp
5.50
mtgoxchf
117.07
123.15
100.00
justeur
150.01
285.25
150.02
fiscojpy
1,000,025.00
1,079,990.00
1,000,025.00
weexaud
880.00
890.00
890.00
surbtcvef
309,003.00
299,999,998.00
309,003.00
bitpaycad
85,895.21
bit2cils
99,512.72
100,050.00
99,233.76
rmbtbcny
1,000.00
5,898.00
5,177.36
bitboxusd
125.00
bitpaygbp
50,070.09
mtgoxgbp
79.08
83.18
81.82
bitmarketpln
32,500.20
32,604.00
32,604.00
coinfloorpln
20,000.00
fybsesek
81,000.00
95,000.00
95,000.00
anxhkgbp
254.60
262.42
159.85
mtgoxjpy
13,659.07
14,191.43
13,959.26
justltc
83.85
200.00
95.09
rockusd
13,500.01
16,369.00
14,890.00
bcmbmgau
0.27
bitxmyr
175,003.00
175,688.00
196,603.00
anxhkeur
334.58
345.83
215.57
thusd
5.59
virwoxsll
2,300,000.00
3,000,000.00
3,000,000.00
bcgbp
99.71
anxhkchf
175.22
223.00
217.24
aqoineur
1.71
indacoinusd
20,000.00
7,500.00
ruxumuah
30.00
ruxumgbp
2.50
thaud
5.90
btctreeusd
6.47
abucoinseur
0.97
7,625.06
5,546.15
getbtcusd
3,841.55
3,876.58
3,793.81
rippleusd
342.87
347.87
327.42
mtgoxdkk
715.58
752.73
1,000.00
anxhkusd
369.74
372.87
244.86
b7eur
3.30
justusd
290.00
450.00
303.13
globalusd
4.70
chilebitclp
40,000.00
8,838,380.00
lakeusd
29,121.00
29,146.03
29,123.81
bcmbmusd
15.00
btcexwmz
5.10
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
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.