Σ

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

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.

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:

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

bitfinexusd

5,659.50

4,855.00

4,994.70

4,994.80

4,994.70

4,994.75

gdaxusd

4,807.50

4,807.51

4,807.51

bitstampusd

5,559.69

4,694.44

4,804.85

4,809.33

4,809.35

5,094.00

oitbitusd

5,557.50

4,669.50

4,804.79

4,810.33

4,811.78

bitflyerjpy

629,670.00

527,229.00

541,500.00

541,773.00

543,051.00

583,619.09

krakeneur

4,869.30

4,000.10

4,129.10

4,129.20

4,129.10

4,406.64

krakenusd

5,564.10

4,700.00

4,820.00

4,820.30

4,820.60

5,094.46

coinsbankeur

4,917.49

4,105.14

4,156.75

4,228.28

4,195.86

4,588.20

geminiusd

4,808.08

4,808.09

4,808.09

coinsbankusd

5,562.88

4,695.99

4,761.04

4,850.70

4,810.34

5,228.96

coincheckjpy

631,959.00

525,214.00

543,046.00

543,714.00

543,025.00

582,818.99

bitstampeur

4,880.31

4,101.00

4,189.57

4,198.63

4,189.42

4,457.20

coinbaseeur

4,879.41

4,105.00

4,169.65

4,169.66

4,202.88

4,419.65

bitbaypln

21,200.27

17,555.00

18,057.00

18,259.00

18,037.01

19,144.37

btcboxjpy

631,915.00

533,264.00

545,200.00

546,289.00

544,838.00

592,116.59

zaifjpy

629,730.00

532,000.00

543,200.00

543,620.00

542,400.00

583,555.25

korbitkrw

6,427,500.00

5,559,000.00

5,696,000.00

5,699,500.00

5,695,000.00

6,001,031.89

coinbasegbp

4,415.00

3,637.02

3,764.30

3,765.00

3,772.53

3,967.83

cexusd

5,622.20

4,670.00

4,879.10

4,880.20

4,880.20

5,190.62

cexiousd

5,621.60

4,670.00

4,879.60

4,880.20

4,879.70

btcdeeur

7,420.00

2,350.00

4,100.00

4,155.80

4,150.00

4,266.10

lakeusd

6,186.73

5,333.49

5,447.40

5,449.61

5,459.47

5,922.46

coinsbankgbp

4,368.84

3,525.09

3,532.16

4,054.97

3,794.77

4,124.70

coinbaseusd

4,736.33

4,880.58

btcmarketsaud

7,590.00

6,428.08

6,560.06

6,573.16

6,573.16

6,994.00

bitxzar

83,401.00

68,666.00

70,486.00

70,487.00

70,487.00

76,532.54

rockeur

4,859.63

4,100.00

4,206.02

4,207.01

4,206.01

4,470.18

cexeur

4,920.60

4,181.50

4,261.20

4,291.30

4,275.00

4,577.06

cexioeur

4,920.60

4,181.50

4,273.50

4,282.80

4,282.70

coinsbitiousd

5,659.50

4,892.50

4,956.00

5,058.40

5,008.10

5,329.43

coinfloorgbp

4,364.00

3,690.00

3,759.00

3,765.00

3,759.00

3,966.63

btcoididr

83,400,000.00

70,645,000.00

72,335,000.00

72,336,000.00

72,336,000.00

78,243,340.96

Market

high

low

bid

ask

close

avg

bitmarketpln

21,272.00

16,923.00

18,148.10

18,290.14

18,297.59

18,839.85

mrcdbrl

21,296.71

17,803.00

18,107.06

18,298.96

18,298.96

19,160.60

bitflyerusd

5,579.00

4,715.50

4,846.20

4,860.30

4,800.40

5,060.06

krakencad

7,499.80

5,857.00

6,324.40

6,369.90

6,370.00

6,677.07

btcalphausd

5,716.10

4,909.51

100,000.00

0.01

5,052.02

5,314.56

bitxngn

2,053,400.00

1,657,000.00

1,775,108.00

1,775,109.00

1,775,109.00

1,893,975.94

itbiteur

4,800.23

4,092.33

4,197.84

4,202.97

4,222.41

wexusd

8,632.00

8,200.00

8,201.59

8,242.59

8,242.65

8,362.21

fybsgsgd

7,729.99

6,651.10

6,602.01

6,700.00

6,651.10

7,080.78

bit2cils

21,449.99

17,500.00

17,500.16

18,095.46

17,570.40

19,003.63

bitbayeur

4,924.51

4,149.99

4,167.23

4,257.87

4,245.00

4,452.65

getbtcusd

5,615.29

4,764.50

4,942.43

4,979.14

4,862.12

5,285.56

bceur

4,830.01

4,030.01

4,064.06

4,251.06

4,051.13

4,366.26

bitbayusd

5,568.66

4,734.44

4,736.77

4,914.83

4,765.43

4,967.18

coinfalconeur

5,082.61

4,170.33

4,160.10

4,352.41

4,266.10

4,583.95

vbtcvnd

131,200,000.00

112,539,400.00

113,864,200.00

115,736,900.00

112,539,400.00

128,183,567.64

omnitradebrl

21,900.00

18,400.00

18,400.00

18,460.00

18,460.00

20,349.31

bitxidr

83,000,000.00

70,000,000.00

70,000,000.00

71,835,000.00

71,835,000.00

77,864,186.14

krakenjpy

633,960.00

525,172.00

530,701.00

555,162.00

543,122.00

589,229.50

fiscojpy

631,100.00

533,505.00

540,000.00

552,175.00

540,005.00

597,811.63

bitmaszynapln

21,283.99

17,644.89

18,112.13

18,112.14

17,954.76

19,030.53

cexrub

369,451.40

350,629.70

351,035.90

352,800.30

351,036.60

353,511.75

wexrub

534,374.06

515,586.72

515,030.00

517,561.34

515,586.72

525,374.13

wexeur

7,881.95

7,565.64

7,565.64

7,603.52

7,580.77

7,740.54

bitkonanusd

5,303.00

4,801.00

4,600.00

4,928.98

4,801.00

5,240.28

bitmarketeur

4,899.29

3,965.25

4,160.58

4,278.00

4,013.15

4,331.08

bitxmyr

12,961.00

10,515.00

10,517.00

11,998.00

11,998.00

12,232.34

bitstockczk

126,000.00

122,785.00

106,992.00

112,453.00

122,785.00

125,219.27

chilebitclp

3,774,030.00

3,300,000.00

3,246,900.00

3,348,310.00

3,300,000.00

3,660,496.82

bitchangepln

10.00

imcexeur

7.71

bitmeltc

27.00

67.76

ruxumpln

13.50

exmousd

778.59

782.00

782.32

ruxumeur

5.00

b7eur

3.30

crytrusd

243.00

265.00

625.00

krakenkrw

495,000.00

545,000.00

525,142.00

mtgoxeur

95.89

98.41

95.89

krakenxrp

103,600.64

104,931.79

103,842.16

weexcad

150.00

120.00

cryptoxaud

22.00

globalpln

15.82

remitanovnd

114,540,529.95

116,468,220.38

153,045,823.05

justeur

150.01

285.25

150.02

rockusd

13,500.01

16,369.00

14,890.00

thaud

5.90

bitcurexpln

1,227.50

1,240.00

2,289.00

anxhkusd

369.74

372.87

244.86

justltc

83.85

200.00

95.09

bitmarketrub

300.00

aqoineur

1.71

weexusd

395.00

395.00

foxbitbrl

24,666.03

25,199.99

24,664.04

btchkexhkd

572.00

btcexwmr

155.00

ruxumuah

30.00

bcmlrusd

11.00

bitcurexusd

615.03

642.84

629.15

rmbtbcny

1,000.00

5,898.00

5,177.36

exmoeur

736.19

739.98

737.57

bcmpxgau

0.20

itbitsgd

6,592.39

6,599.83

8,858.85

bitsomxn

187,000.99

188,000.00

5,200.00

abucoinspln

29,246.93

29,450.00

29,450.00

justusd

290.00

450.00

303.13

bitomatpln

29.20

ibwteur

10,000.00

1.00

btcncny

28,158.00

28,399.99

28,158.00

btcxchangeron

1,155.36

1,169.07

1,800.00

chbtccny

27,028.19

28,000.00

27,197.00

ruxumhuf

79.00

ruxumchf

3.00

bbmbrl

18.00

bcgbp

99.71

mtgoxhkd

1,021.53

1,074.57

1,001.00

bitmarketusd

14.00

snwcnxrp

8,999.00

1coinusd

222.80

223.00

253.80

b2cusd

6.50

anxhkcny

2,430.00

2,578.25

1,553.74

btc2ubrl

654.50

659.99

654.50

anxhksgd

514.29

544.96

341.73

btccusd

6,651.13

6,899.76

6,700.00

ruxumjpy

210.00

justxrp

25,000.00

74,998.00

64,001.00

ripplexrp

71,364.47

71,467.41

69,707.31

surbtcvef

200,004.00

2,999,997.00

200,002.00

btcexrub

199.00

btc24usd

73.00

mtgoxrub

4,683.29

4,926.43

5,899.99

btctreeusd

6.47

cbxusd

11.00

9,000.00

10,000.00

freshpln

25.00

lybitcad

104.97

bidxtrmpln

1,751.00

ruxumhkd

29.00

bitalogbp

1,896,343.19

340.00

virtexcad

548.00

550.00

550.00

btcexusd

6.80

bit121gbp

300.00

300.00

btc24eur

412.00

503.00

412.00

btcexeur

3.90

globalgbp

2.99

globalusd

4.70

thinr

318.00

zyadoeur

4,858.95

4,860.96

4,861.73

ruxumzar

25.00

intrsngeur

316.54

419.00

308.01

weexaud

880.00

890.00

890.00

coinbasecad

855.00

861.74

861.74

ruxumusd

14.75

vcxeur

726.00

6,400.00

6,400.00

bitalopln

1,700.00

1,950.00

cryptoniteur

3,859.00

5,017.05

5,869.78

ibwtgbp

950.00

287.00

wbxaud

26.00

26.00

thusd

5.59

abucoinseur

0.97

7,625.06

5,546.15

b7usd

4.75

btcexwmz

5.10

intrsnggbp

271.40

376.18

376.18

anxhkjpy

41,227.18

49,140.39

29,436.15

ruxumsek

20.00

exchbusd

3.64

anxhkchf

175.22

223.00

217.24

mtgoxjpy

13,659.07

14,191.43

13,959.26

hitbtcusd

7,906.62

7,910.00

7,915.48

anxhkeur

334.58

345.83

215.57

ruxumrub

195.00

mtgoxgbp

79.08

83.18

81.82

anxhknzd

555.72

588.51

371.29

urdubitpkr

700,000.00

850,000.00

700,000.00

virwoxsll

1,640,630.00

1,689,589.00

1,689,589.00

mtgoxchf

117.07

123.15

100.00

indacoinusd

20,000.00

7,500.00

anxhkcad

506.84

536.04

317.09

bcmbmgau

0.27

vcxusd

1,501.00

10,000.00

6,500.00

cryptoxusd

13.35

mtgoxthb

4,017.41

4,830.52

3,500.00

globaleur

4.00

rippleusd

342.87

347.87

327.42

bitcurexeur

569.99

595.86

573.00

bitboxusd

125.00

rippleeur

265.00

258.00

fluctopln

37,217.30

26,021.26

mtgoxsek

857.00

901.50

1,046.41

anxhkaud

512.20

541.93

333.85

cotrusd

411.40

473.99

391.98

nevbitpln

20,424.00

38,920.15

24,769.52

fbtcusd

165.00

abucoinsusd

0.61

8,210.51

8,210.51

hitbtceur

2,501.31

4,499.99

4,499.99

bitalousd

9,100.00

600.00

bcmbmusd

15.00

btcexyad

132.00

thlrusd

4.35

bitmarketaud

14.00

anxhkgbp

254.60

262.42

159.85

kptnsek

3,200.00

3,468.47

3,468.47

btcexjpy

1.00

ruxumsgd

5.20

jubicny

27,150.00

27,599.00

27,599.00

mtgoxnzd

158.78

167.02

151.00

mtgoxsgd

166.98

175.65

200.00

mtgoxcny

803.10

844.80

784.38

mtgoxaud

146.44

154.04

144.30

bitcashczk

6,700.00

rocksll

18,050.00

krakennmc

1,186.11

1,271.46

1,271.46

bitaloeur

6,900.00

306.00

200.00

justnok

1,100.00

2,298.00

2,058.00

intrsngpln

335.00

allcoinusd

16,500.00

17,350.00

16,500.00

ruxumthb

135.00

btctradecny

22,020.10

22,199.00

24,821.00

bcmmbusd

10.00

crytreur

210.00

298.00

481.12

krakengbp

2,990.00

3,240.00

3,018.00

mtgoxdkk

715.58

752.73

1,000.00

bitmeusd

86.00

thclp

3,050.00

mtgoxpln

484.87

517.15

403.06

anxhkhkd

2,857.96

2,919.43

1,907.34

imcexusd

20.00

lybitusd

119.00

bitfloorusd

100.00

fybsesek

57,700.01

71,999.99

65,500.00

ruxumaud

4.25

bcmppusd

23.50

mtgoxcad

146.17

153.76

120.01

intrsngusd

11.90

btceureur

357.70

403.82

255.00

ibwtusd

1,200.00

500.00

krakenltc

161.34

162.07

160.56

fbtceur

125.00

bitmarketgbp

5.50

ibwtltc

300.00

1.00

britcoingbp

3.66

bitnznzd

1,200.00

2,000.00

2,000.00

ruxumgbp

2.50

exmorub

47,468.00

47,620.00

47,435.00

bitpayeur

4,198.49

maicointwd

146,632.13

155,893.12

154,349.62

bitpaychf

4,788.72

bitpaygbp

3,759.00

bitpayaud

6,608.60

bitpayusd

4,820.13

bitpayjpy

542,271.09

bitpaycad

6,347.13

bitpaycny

33,461.51

maicoinusd

4,740.76

5,040.19

4,990.28

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

krakenxmr

67.07357972

67.29022273

66.91648822

bitfinexdash

44.70472529

44.6090021

44.51963316

poloniexxem

58,445.35359439

58,651.02639296

58,445.35359439

poloniexeth

32.46753247

32.58509271

32.46982011

bitfinexeth

32.56374353

32.59664906

32.5849653

bittrexxrp

10,235.41453429

10,236.46227864

10,235.41453429

bittrexxmr

66.83464441

67.11409396

66.83580581

krakendash

44.54342984

44.64285714

44.54342984

krakenxrp

10,243.80249949

10,254.30680886

10,221.81334969

bitfinexltc

132.7069565

132.79507065

132.73337846

bitfinexxmr

67.08707903

67.18172657

67.15014773

poloniexxrp

10,223.90348635

10,238.55841098

10,224.94887526

poloniexltc

132.62599469

132.80212483

132.46401615

bitfinexxrp

10,235.41453429

10,241.70421958

10,237.51023751

bitstampxrp

10,243.80249949

10,243.80249949

10,230.17902813

bittrexxem

58,309.03790087

58,582.30814294

58,241.11822947

krakeneth

32.62642741

32.61578604

32.59452412

geminieth

32.58390355

32.61578604

32.5414904

bittrexeth

32.53338088

32.56727503

32.54790889

gdaxltc

132.62599469

132.80212483

132.62599469

bittrexltc

132.71435359

132.71435359

132.21514577

poloniexdash

44.43952647

44.60715151

44.43952647

gdaxeth

32.5732899

32.58390355

32.5732899

krakenltc

132.32764324

132.83740701

132.50298132

poloniexxmr

67.21699461

67.27211571

67.22372729

bittrexdash

44.78386634

44.7559258

44.35760212

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.