We allow the ability to generate mixes via API.

To initiate a new mix, send a GET request to https://www.privcoin.cc/{cointype}/api/ or replace https://www.privcoin.cc/ with http://privc5o5k2upcou3i33ikr7ek2azxogx4s5xdmyghw2exethy3e2iqqd.onion for TOR usage.

Available coin types are:

• bitcoin - https://www.privcoin.cc/bitcoin/api/
• bitcoincash - https://www.privcoin.cc/bitcoincash/api/
• ethereum - https://www.privcoin.cc/ethereum/api/
• litecoin - https://www.privcoin.cc/litecoin/api/

Required parameters are:

addr1 - first forward address. Ethereum can only have up to 3 forward addresses, the other coins can have up to 10.

pr1 - percent distribution for the first address.

time1 - time delay for the first address in hours, 0-24.

...

...

bitcode - your previous transaction id if you have one. OPTIONAL PARAMETER

affiliate - your affiliate string if you have one. OPTIONAL PARAMETER. If my affiliate link is https://www.privcoin.cc/?ref=ac7f298 then in your API call ONLY USE ac7f298

fee - custom fee. Ethereum and Litecoin have minimums of 2, Bitcoin and Bitcoin cash have minimums of 0.8

Example:

https://www.privcoin.cc/bitcoin/api/?addr1=1Fn1jqxn8FzxGRjKioqHzg1SJ5HKnyDdoV&pr1=33&time1=8&addr2=16trmas6Tdkcc41WZjttkY4UEjr2mN2ytK&pr2=67&t2=1&bitcode=a83ab21&fee=1.231&affiliate=ac7f298

Response:

JSON ENCODED DATA

status = success or fail

message (ONLY ON STATUS FAIL) = the error message why the mix creation failed.

bitcode = the transaction id also known as bitcode for the mix

address = the address to send the coins to

minamount = the minimum acceptable amount

maxamount = the most the user can mix based on their previous transactions with us

Example success:

{"status":"success","bitcode":"dd23eaad","address":"1292QgkMx9ENDLjMbXhmi8pDh1RLGYbBZF","minamount":0.01,"maxamount":30}

Example failure:

{"status":"fail","message":"Fee is below minimum level."}

To check a mix

https://www.privcoin.cc/status/?id={bitcode above}

Example: https://www.privcoin.cc/status/?id=dd23eaad

totalBalance = total coins sent including confirmed and unconfirmed

confirmedBalance = total coins ready for forwarding

letterDownloaded = has the user downloaded letter of guarantee

confirmationsRequired = total confirmations required before we will forward coins

Example response: {"totalBalance":1.9483,"confirmedBalance":0,"letterDownloaded":"1","confirmationsRequired":1}

To get Letter of Guarantee

https://www.privcoin.cc/signature/?api=true&id={bitcode above}

Example: https://www.privcoin.cc/signature/?api=true&id=dd23eaad

Letter of guarantee will be JSON encoded