Introduction

This API is a way to interact with your AdCoin Wallet without using the provided interface

Overview

With this API you can see your account details, orders, transactions and addresses. You can also create orders, addresses and pay people with AdCoin. Create payment requests via our payment gateway etc.

https://wallet.getadcoin.com/api

Authentication

This API uses a 'X-AUTH-TOKEN' header for authentication and must be included in every request to the API. This header is specific to each account and strictly confidential.

Rate Limit

The AdCoin Wallet API does not have a rate limit

Status codes
200 Request succesful
201 When the specified entity is succesfully created.
400 When a required parameter is missing or a parameter is invalid.
500 When our server does something it's not supposed to do.

POST /api/payments

Create new payment for the payment gateway You should redirect the user to the links.paymentUrl After the payment is paid the user is redirected to the given redirectUrl
When the required amount of confirmations (6) is achieved, the webhookUrl gets called with form fields filled with payment data:

id: "Payment ID"
created_at: "Payment created at"
status: "Payment status" # Should be confirmed for you to fulfill the payment
metadata: "Payment metadata"
hash: "Hash" # See note 1


Note 1: The hash is made of all given data as a http query, eg: id=5ded13a4-0f13-11e8-a1f5-0242ac130004&created_at=2018-02-11T10%3A07%3A28%2B00%3A00&status=pending
This is then hashed with HMAC SHA512 using your private key

If this isn't true, you should consider the request as malicious.

Sample request
curl --request POST \
  --url https://wallet.getadcoin.com/api/payments \
  --header 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  --form amount=100 \
  --form redirectUrl=http://myapp.com/checkout/status \
  --form webhookUrl=http://myapp.com/checkout/webhook \
  --form 'description=500 advertisement credits' \
  --form 'metadata={"name": "TestUser"}'
Sample response
{
  "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
  "status": "open",
  "created_at": "2018-02-11T10:45:41+00:00",
  "expires_at": "2018-02-11T11:00:41+00:00",
  "amount": 100,
  "description": "500 advertisement credits",
  "metadata": "{\"name\": \"TestUser\"}",
  "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
  "links": {
    "redirectUrl": "http://myapp.com/checkout/status",
    "webhookUrl": "http://myapp.com/checkout/webhook",
    "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
  }
}
Sample request
require 'uri'
require 'net/http'

url = URI("https://wallet.getadcoin.com/api/payments")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request.body = "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"amount\"\r\n\r\n100\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"redirectUrl\"\r\n\r\nhttp://myapp.com/checkout/status\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"webhookUrl\"\r\n\r\nhttp://myapp.com/checkout/webhook\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n500 advertisement credits\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"metadata\"\r\n\r\n{\"name\": \"TestUser\"}\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--"

response = http.request(request)
puts response.read_body
Sample response
{
  "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
  "status": "open",
  "created_at": "2018-02-11T10:45:41+00:00",
  "expires_at": "2018-02-11T11:00:41+00:00",
  "amount": 100,
  "description": "500 advertisement credits",
  "metadata": "{\"name\": \"TestUser\"}",
  "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
  "links": {
    "redirectUrl": "http://myapp.com/checkout/status",
    "webhookUrl": "http://myapp.com/checkout/webhook",
    "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
  }
}
Sample request
import requests

url = "https://wallet.getadcoin.com/api/payments"

payload = "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"amount\"\r\n\r\n100\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"redirectUrl\"\r\n\r\nhttp://myapp.com/checkout/status\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"webhookUrl\"\r\n\r\nhttp://myapp.com/checkout/webhook\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n500 advertisement credits\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"metadata\"\r\n\r\n{\"name\": \"TestUser\"}\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--"
response = requests.request("POST", url, data=payload)

print(response.text)
Sample response
{
  "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
  "status": "open",
  "created_at": "2018-02-11T10:45:41+00:00",
  "expires_at": "2018-02-11T11:00:41+00:00",
  "amount": 100,
  "description": "500 advertisement credits",
  "metadata": "{\"name\": \"TestUser\"}",
  "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
  "links": {
    "redirectUrl": "http://myapp.com/checkout/status",
    "webhookUrl": "http://myapp.com/checkout/webhook",
    "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
  }
}
Sample request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
 CURLOPT_URL => "https://wallet.getadcoin.com/api/payments",
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "POST",
 CURLOPT_POSTFIELDS => "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"amount\"\r\n\r\n100\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"redirectUrl\"\r\n\r\nhttp://myapp.com/checkout/status\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"webhookUrl\"\r\n\r\nhttp://myapp.com/checkout/webhook\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n500 advertisement credits\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"metadata\"\r\n\r\n{\"name\": \"TestUser\"}\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--",
 CURLOPT_HTTPHEADER => array(
 "content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW"
 ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
 echo "cURL Error #:" . $err;
} else {
 echo $response;
}
Sample response
{
  "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
  "status": "open",
  "created_at": "2018-02-11T10:45:41+00:00",
  "expires_at": "2018-02-11T11:00:41+00:00",
  "amount": 100,
  "description": "500 advertisement credits",
  "metadata": "{\"name\": \"TestUser\"}",
  "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
  "links": {
    "redirectUrl": "http://myapp.com/checkout/status",
    "webhookUrl": "http://myapp.com/checkout/webhook",
    "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
  }
}
Sample request
var form = new FormData();
form.append("amount", "100");
form.append("redirectUrl", "http://myapp.com/checkout/status");
form.append("webhookUrl", "http://myapp.com/checkout/webhook");
form.append("description", "500 advertisement credits");
form.append("metadata", "{\"name\": \"TestUser\"}");

var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://wallet.getadcoin.com/api/payments",
  "method": "POST",
  "headers": {},
  "processData": false,
  "contentType": false,
  "mimeType": "multipart/form-data",
  "data": form
}

$.ajax(settings).done(function (response) {
  console.log(response);
});
Sample response
{
  "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
  "status": "open",
  "created_at": "2018-02-11T10:45:41+00:00",
  "expires_at": "2018-02-11T11:00:41+00:00",
  "amount": 100,
  "description": "500 advertisement credits",
  "metadata": "{\"name\": \"TestUser\"}",
  "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
  "links": {
    "redirectUrl": "http://myapp.com/checkout/status",
    "webhookUrl": "http://myapp.com/checkout/webhook",
    "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
  }
}
Sample request
var http = require("https");

var options = {
  "method": "POST",
  "hostname": [
    "wallet",
    "getadcoin",
    "com"
  ],
  "path": [
    "api",
    "payments"
  ],
  "headers": {}
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write("------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"amount\"\r\n\r\n100\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"redirectUrl\"\r\n\r\nhttp://myapp.com/checkout/status\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"webhookUrl\"\r\n\r\nhttp://myapp.com/checkout/webhook\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n500 advertisement credits\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"metadata\"\r\n\r\n{\"name\": \"TestUser\"}\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--");
req.end();
Sample response
{
  "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
  "status": "open",
  "created_at": "2018-02-11T10:45:41+00:00",
  "expires_at": "2018-02-11T11:00:41+00:00",
  "amount": 100,
  "description": "500 advertisement credits",
  "metadata": "{\"name\": \"TestUser\"}",
  "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
  "links": {
    "redirectUrl": "http://myapp.com/checkout/status",
    "webhookUrl": "http://myapp.com/checkout/webhook",
    "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
  }
}
Sample request
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://wallet.getadcoin.com/api/payments"

	payload := strings.NewReader("------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"amount\"\r\n\r\n100\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"redirectUrl\"\r\n\r\nhttp://myapp.com/checkout/status\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"webhookUrl\"\r\n\r\nhttp://myapp.com/checkout/webhook\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"description\"\r\n\r\n500 advertisement credits\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"metadata\"\r\n\r\n{\"name\": \"TestUser\"}\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--")

	req, _ := http.NewRequest("POST", url, payload)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
Sample response
{
  "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
  "status": "open",
  "created_at": "2018-02-11T10:45:41+00:00",
  "expires_at": "2018-02-11T11:00:41+00:00",
  "amount": 100,
  "description": "500 advertisement credits",
  "metadata": "{\"name\": \"TestUser\"}",
  "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
  "links": {
    "redirectUrl": "http://myapp.com/checkout/status",
    "webhookUrl": "http://myapp.com/checkout/webhook",
    "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
  }
}

GET /api/payments

Get all payments

Sample request
curl --request GET \
  --url https://wallet.getadcoin.com/api/payments
Sample response
[
  {
    "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
    "mode": "live",
    "status": "open",
    "created_at": "2018-02-11T10:45:41+00:00",
    "expires_at": "2018-02-11T11:00:41+00:00",
    "amount": 100,
    "description": "500 advertisement credits",
    "metadata": "{\"name\": \"TestUser\"}",
    "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
    "links": {
      "redirectUrl": "http://myapp.com/checkout/status",
      "webhookUrl": "http://myapp.com/checkout/webhook",
      "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
    }
  }
]
Sample request
require 'uri'
require 'net/http'

url = URI("https://wallet.getadcoin.com/api/payments")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
Sample response
[
  {
    "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
    "mode": "live",
    "status": "open",
    "created_at": "2018-02-11T10:45:41+00:00",
    "expires_at": "2018-02-11T11:00:41+00:00",
    "amount": 100,
    "description": "500 advertisement credits",
    "metadata": "{\"name\": \"TestUser\"}",
    "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
    "links": {
      "redirectUrl": "http://myapp.com/checkout/status",
      "webhookUrl": "http://myapp.com/checkout/webhook",
      "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
    }
  }
]
Sample request
import requests

url = "https://wallet.getadcoin.com/api/payments"

response = requests.request("GET", url)

print(response.text)
Sample response
[
  {
    "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
    "mode": "live",
    "status": "open",
    "created_at": "2018-02-11T10:45:41+00:00",
    "expires_at": "2018-02-11T11:00:41+00:00",
    "amount": 100,
    "description": "500 advertisement credits",
    "metadata": "{\"name\": \"TestUser\"}",
    "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
    "links": {
      "redirectUrl": "http://myapp.com/checkout/status",
      "webhookUrl": "http://myapp.com/checkout/webhook",
      "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
    }
  }
]
Sample request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
 CURLOPT_URL => "https://wallet.getadcoin.com/api/payments",
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
 echo "cURL Error #:" . $err;
} else {
 echo $response;
}
Sample response
[
  {
    "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
    "mode": "live",
    "status": "open",
    "created_at": "2018-02-11T10:45:41+00:00",
    "expires_at": "2018-02-11T11:00:41+00:00",
    "amount": 100,
    "description": "500 advertisement credits",
    "metadata": "{\"name\": \"TestUser\"}",
    "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
    "links": {
      "redirectUrl": "http://myapp.com/checkout/status",
      "webhookUrl": "http://myapp.com/checkout/webhook",
      "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
    }
  }
]
Sample request
var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://wallet.getadcoin.com/api/payments",
  "method": "GET",
  "headers": {}
}

$.ajax(settings).done(function (response) {
  console.log(response);
});
Sample response
[
  {
    "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
    "mode": "live",
    "status": "open",
    "created_at": "2018-02-11T10:45:41+00:00",
    "expires_at": "2018-02-11T11:00:41+00:00",
    "amount": 100,
    "description": "500 advertisement credits",
    "metadata": "{\"name\": \"TestUser\"}",
    "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
    "links": {
      "redirectUrl": "http://myapp.com/checkout/status",
      "webhookUrl": "http://myapp.com/checkout/webhook",
      "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
    }
  }
]
Sample request
var http = require("https");

var options = {
  "method": "GET",
  "hostname": [
    "wallet",
    "getadcoin",
    "com"
  ],
  "path": [
    "api",
    "payments"
  ],
  "headers": {}
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
Sample response
[
  {
    "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
    "mode": "live",
    "status": "open",
    "created_at": "2018-02-11T10:45:41+00:00",
    "expires_at": "2018-02-11T11:00:41+00:00",
    "amount": 100,
    "description": "500 advertisement credits",
    "metadata": "{\"name\": \"TestUser\"}",
    "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
    "links": {
      "redirectUrl": "http://myapp.com/checkout/status",
      "webhookUrl": "http://myapp.com/checkout/webhook",
      "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
    }
  }
]
Sample request
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://wallet.getadcoin.com/api/payments"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
Sample response
[
  {
    "id": "b43292ea-0f18-11e8-8dd3-0242ac130003",
    "mode": "live",
    "status": "open",
    "created_at": "2018-02-11T10:45:41+00:00",
    "expires_at": "2018-02-11T11:00:41+00:00",
    "amount": 100,
    "description": "500 advertisement credits",
    "metadata": "{\"name\": \"TestUser\"}",
    "address": "APNa7eDYEQzYAGb7PqrRGwSFLjCfFpwXrA",
    "links": {
      "redirectUrl": "http://myapp.com/checkout/status",
      "webhookUrl": "http://myapp.com/checkout/webhook",
      "paymentUrl": "http://wallet.getadcoin.com/pay/b43292ea-0f18-11e8-8dd3-0242ac130003"
    }
  }
]

GET /me

Get basic account information

Sample request
curl --request GET \
  --url https://wallet.getadcoin.com/api/me
Sample response
{
  "name": "John Doe",
  "email": "john@doe.com",
  "type": "premium",
  "address": "Avenue 1",
  "postalCode": "21435",
  "city": "New York",
  "country": "United States"
}
Sample request
require 'uri'
require 'net/http'

url = URI("https://wallet.getadcoin.com/api/me")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
Sample response
{
  "name": "John Doe",
  "email": "john@doe.com",
  "type": "premium",
  "address": "Avenue 1",
  "postalCode": "21435",
  "city": "New York",
  "country": "United States"
}
Sample request
import requests

url = "https://wallet.getadcoin.com/api/me"

response = requests.request("GET", url)

print(response.text)
Sample response
{
  "name": "John Doe",
  "email": "john@doe.com",
  "type": "premium",
  "address": "Avenue 1",
  "postalCode": "21435",
  "city": "New York",
  "country": "United States"
}
Sample request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
 CURLOPT_URL => "https://wallet.getadcoin.com/api/me",
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
 echo "cURL Error #:" . $err;
} else {
 echo $response;
}
Sample response
{
  "name": "John Doe",
  "email": "john@doe.com",
  "type": "premium",
  "address": "Avenue 1",
  "postalCode": "21435",
  "city": "New York",
  "country": "United States"
}
Sample request
var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://wallet.getadcoin.com/api/me",
  "method": "GET",
  "headers": {}
}

$.ajax(settings).done(function (response) {
  console.log(response);
});
Sample response
{
  "name": "John Doe",
  "email": "john@doe.com",
  "type": "premium",
  "address": "Avenue 1",
  "postalCode": "21435",
  "city": "New York",
  "country": "United States"
}
Sample request
var http = require("https");

var options = {
  "method": "GET",
  "hostname": [
    "wallet",
    "getadcoin",
    "com"
  ],
  "path": [
    "api",
    "me"
  ],
  "headers": {}
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
Sample response
{
  "name": "John Doe",
  "email": "john@doe.com",
  "type": "premium",
  "address": "Avenue 1",
  "postalCode": "21435",
  "city": "New York",
  "country": "United States"
}
Sample request
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://wallet.getadcoin.com/api/me"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
Sample response
{
  "name": "John Doe",
  "email": "john@doe.com",
  "type": "premium",
  "address": "Avenue 1",
  "postalCode": "21435",
  "city": "New York",
  "country": "United States"
}

GET /orders

Get all orders

Sample request
curl --request GET \
  --url https://wallet.getadcoin.com/api/orders
Sample response
[
  {
    "euroAmount": 100,
    "adCoinAmount": 200,
    "createdAt": 1511616897
  },
  {
    "euroAmount": 200,
    "adCoinAmount": 400,
    "createdAt": 1511617090
  }
]
Sample request
require 'uri'
require 'net/http'

url = URI("https://wallet.getadcoin.com/api/orders")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
Sample response
[
  {
    "euroAmount": 100,
    "adCoinAmount": 200,
    "createdAt": 1511616897
  },
  {
    "euroAmount": 200,
    "adCoinAmount": 400,
    "createdAt": 1511617090
  }
]
Sample request
import requests

url = "https://wallet.getadcoin.com/api/orders"

response = requests.request("GET", url)

print(response.text)
Sample response
[
  {
    "euroAmount": 100,
    "adCoinAmount": 200,
    "createdAt": 1511616897
  },
  {
    "euroAmount": 200,
    "adCoinAmount": 400,
    "createdAt": 1511617090
  }
]
Sample request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
 CURLOPT_URL => "https://wallet.getadcoin.com/api/orders",
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
 echo "cURL Error #:" . $err;
} else {
 echo $response;
}
Sample response
[
  {
    "euroAmount": 100,
    "adCoinAmount": 200,
    "createdAt": 1511616897
  },
  {
    "euroAmount": 200,
    "adCoinAmount": 400,
    "createdAt": 1511617090
  }
]
Sample request
var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://wallet.getadcoin.com/api/orders",
  "method": "GET",
  "headers": {}
}

$.ajax(settings).done(function (response) {
  console.log(response);
});
Sample response
[
  {
    "euroAmount": 100,
    "adCoinAmount": 200,
    "createdAt": 1511616897
  },
  {
    "euroAmount": 200,
    "adCoinAmount": 400,
    "createdAt": 1511617090
  }
]
Sample request
var http = require("https");

var options = {
  "method": "GET",
  "hostname": [
    "wallet",
    "getadcoin",
    "com"
  ],
  "path": [
    "api",
    "orders"
  ],
  "headers": {}
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
Sample response
[
  {
    "euroAmount": 100,
    "adCoinAmount": 200,
    "createdAt": 1511616897
  },
  {
    "euroAmount": 200,
    "adCoinAmount": 400,
    "createdAt": 1511617090
  }
]
Sample request
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://wallet.getadcoin.com/api/orders"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
Sample response
[
  {
    "euroAmount": 100,
    "adCoinAmount": 200,
    "createdAt": 1511616897
  },
  {
    "euroAmount": 200,
    "adCoinAmount": 400,
    "createdAt": 1511617090
  }
]

POST /orders

Create a new order amount: Amount in Euro paymentmethod: One of the paymentmethods returned by /paymentmethods idealIssuer: iDeal issuer, only required if paymentmethod is 'ideal' coin: Coin to use, only required if paymentmethod is 'cryptocurrency'

Sample request
curl --request POST \
  --url https://wallet.getadcoin.com/api/orders \
  --header 'amount: 10' \
  --header 'idealIssuer: RABONL2U' \
  --header 'paymentMethod: ideal'
Sample response
{
  "redirectUrl": "https://urlofpaymentprovider.com/thatisusedtopay"
}
Sample request
require 'uri'
require 'net/http'

url = URI("https://wallet.getadcoin.com/api/orders")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["amount"] = '10'
request["paymentMethod"] = 'ideal'
request["idealIssuer"] = 'RABONL2U'

response = http.request(request)
puts response.read_body
Sample response
{
  "redirectUrl": "https://urlofpaymentprovider.com/thatisusedtopay"
}
Sample request
import requests

url = "https://wallet.getadcoin.com/api/orders"

headers = {
    'amount': "10",
    'paymentMethod': "ideal",
    'idealIssuer': "RABONL2U"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
Sample response
{
  "redirectUrl": "https://urlofpaymentprovider.com/thatisusedtopay"
}
Sample request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
 CURLOPT_URL => "https://wallet.getadcoin.com/api/orders",
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "POST",
 CURLOPT_HTTPHEADER => array(
 "amount: 10",
 "idealIssuer: RABONL2U",
 "paymentMethod: ideal"
 ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
 echo "cURL Error #:" . $err;
} else {
 echo $response;
}
Sample response
{
  "redirectUrl": "https://urlofpaymentprovider.com/thatisusedtopay"
}
Sample request
var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://wallet.getadcoin.com/api/orders",
  "method": "POST",
  "headers": {
    "amount": "10",
    "paymentMethod": "ideal",
    "idealIssuer": "RABONL2U"
  }
}

$.ajax(settings).done(function (response) {
  console.log(response);
});
Sample response
{
  "redirectUrl": "https://urlofpaymentprovider.com/thatisusedtopay"
}
Sample request
var http = require("https");

var options = {
  "method": "POST",
  "hostname": [
    "wallet",
    "getadcoin",
    "com"
  ],
  "path": [
    "api",
    "orders"
  ],
  "headers": {
    "amount": "10",
    "paymentMethod": "ideal",
    "idealIssuer": "RABONL2U"
  }
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
Sample response
{
  "redirectUrl": "https://urlofpaymentprovider.com/thatisusedtopay"
}
Sample request
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://wallet.getadcoin.com/api/orders"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("amount", "10")
	req.Header.Add("paymentMethod", "ideal")
	req.Header.Add("idealIssuer", "RABONL2U")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
Sample response
{
  "redirectUrl": "https://urlofpaymentprovider.com/thatisusedtopay"
}

GET /paymentmethods

Get available payment methods for a new order

Sample request
curl --request GET \
  --url https://wallet.getadcoin.com/api/paymentmethods
Sample response
{
  "paymentMethods": {
    "mistercash": {
      "code": "mistercash",
      "label": "Bancontact"
    },
    "giropay": {
      "code": "giropay",
      "label": "GiroPay"
    },
    "ideal": {
      "code": "ideal",
      "label": "iDEAL",
      "options": [
        {
          "key": "ABNANL2A",
          "label": "ABN Amro Bank"
        },
        {
          "key": "ASNBNL21",
          "label": "ASN Bank"
        },
        {
          "key": "BUNQNL2A",
          "label": "bunq"
        },
        {
          "key": "INGBNL2A",
          "label": "ING"
        },
        {
          "key": "KNABNL2H",
          "label": "Knab"
        },
        {
          "key": "RABONL2U",
          "label": "Rabobank"
        },
        {
          "key": "RBRBNL21",
          "label": "RegioBank"
        },
        {
          "key": "SNSBNL2A",
          "label": "SNS Bank"
        },
        {
          "key": "TRIONL2U",
          "label": "Triodos Bank"
        },
        {
          "key": "FVLBNL22",
          "label": "Van Lanschot Bankiers"
        }
      ]
    },
    "sofortbanking": {
      "code": "sofortbanking",
      "label": "SofortBanking"
    },
    "cryptocurrency": {
      "key": "cryptocurrency",
      "label": "Cryptocurrency",
      "options": [
        {
          "key": "BTC",
          "label": "Bitcoin"
        }
      ]
    }
  }
}
Sample request
require 'uri'
require 'net/http'

url = URI("https://wallet.getadcoin.com/api/paymentmethods")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
Sample response
{
  "paymentMethods": {
    "mistercash": {
      "code": "mistercash",
      "label": "Bancontact"
    },
    "giropay": {
      "code": "giropay",
      "label": "GiroPay"
    },
    "ideal": {
      "code": "ideal",
      "label": "iDEAL",
      "options": [
        {
          "key": "ABNANL2A",
          "label": "ABN Amro Bank"
        },
        {
          "key": "ASNBNL21",
          "label": "ASN Bank"
        },
        {
          "key": "BUNQNL2A",
          "label": "bunq"
        },
        {
          "key": "INGBNL2A",
          "label": "ING"
        },
        {
          "key": "KNABNL2H",
          "label": "Knab"
        },
        {
          "key": "RABONL2U",
          "label": "Rabobank"
        },
        {
          "key": "RBRBNL21",
          "label": "RegioBank"
        },
        {
          "key": "SNSBNL2A",
          "label": "SNS Bank"
        },
        {
          "key": "TRIONL2U",
          "label": "Triodos Bank"
        },
        {
          "key": "FVLBNL22",
          "label": "Van Lanschot Bankiers"
        }
      ]
    },
    "sofortbanking": {
      "code": "sofortbanking",
      "label": "SofortBanking"
    },
    "cryptocurrency": {
      "key": "cryptocurrency",
      "label": "Cryptocurrency",
      "options": [
        {
          "key": "BTC",
          "label": "Bitcoin"
        }
      ]
    }
  }
}
Sample request
import requests

url = "https://wallet.getadcoin.com/api/paymentmethods"

response = requests.request("GET", url)

print(response.text)
Sample response
{
  "paymentMethods": {
    "mistercash": {
      "code": "mistercash",
      "label": "Bancontact"
    },
    "giropay": {
      "code": "giropay",
      "label": "GiroPay"
    },
    "ideal": {
      "code": "ideal",
      "label": "iDEAL",
      "options": [
        {
          "key": "ABNANL2A",
          "label": "ABN Amro Bank"
        },
        {
          "key": "ASNBNL21",
          "label": "ASN Bank"
        },
        {
          "key": "BUNQNL2A",
          "label": "bunq"
        },
        {
          "key": "INGBNL2A",
          "label": "ING"
        },
        {
          "key": "KNABNL2H",
          "label": "Knab"
        },
        {
          "key": "RABONL2U",
          "label": "Rabobank"
        },
        {
          "key": "RBRBNL21",
          "label": "RegioBank"
        },
        {
          "key": "SNSBNL2A",
          "label": "SNS Bank"
        },
        {
          "key": "TRIONL2U",
          "label": "Triodos Bank"
        },
        {
          "key": "FVLBNL22",
          "label": "Van Lanschot Bankiers"
        }
      ]
    },
    "sofortbanking": {
      "code": "sofortbanking",
      "label": "SofortBanking"
    },
    "cryptocurrency": {
      "key": "cryptocurrency",
      "label": "Cryptocurrency",
      "options": [
        {
          "key": "BTC",
          "label": "Bitcoin"
        }
      ]
    }
  }
}
Sample request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
 CURLOPT_URL => "https://wallet.getadcoin.com/api/paymentmethods",
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
 echo "cURL Error #:" . $err;
} else {
 echo $response;
}
Sample response
{
  "paymentMethods": {
    "mistercash": {
      "code": "mistercash",
      "label": "Bancontact"
    },
    "giropay": {
      "code": "giropay",
      "label": "GiroPay"
    },
    "ideal": {
      "code": "ideal",
      "label": "iDEAL",
      "options": [
        {
          "key": "ABNANL2A",
          "label": "ABN Amro Bank"
        },
        {
          "key": "ASNBNL21",
          "label": "ASN Bank"
        },
        {
          "key": "BUNQNL2A",
          "label": "bunq"
        },
        {
          "key": "INGBNL2A",
          "label": "ING"
        },
        {
          "key": "KNABNL2H",
          "label": "Knab"
        },
        {
          "key": "RABONL2U",
          "label": "Rabobank"
        },
        {
          "key": "RBRBNL21",
          "label": "RegioBank"
        },
        {
          "key": "SNSBNL2A",
          "label": "SNS Bank"
        },
        {
          "key": "TRIONL2U",
          "label": "Triodos Bank"
        },
        {
          "key": "FVLBNL22",
          "label": "Van Lanschot Bankiers"
        }
      ]
    },
    "sofortbanking": {
      "code": "sofortbanking",
      "label": "SofortBanking"
    },
    "cryptocurrency": {
      "key": "cryptocurrency",
      "label": "Cryptocurrency",
      "options": [
        {
          "key": "BTC",
          "label": "Bitcoin"
        }
      ]
    }
  }
}
Sample request
var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://wallet.getadcoin.com/api/paymentmethods",
  "method": "GET",
  "headers": {}
}

$.ajax(settings).done(function (response) {
  console.log(response);
});
Sample response
{
  "paymentMethods": {
    "mistercash": {
      "code": "mistercash",
      "label": "Bancontact"
    },
    "giropay": {
      "code": "giropay",
      "label": "GiroPay"
    },
    "ideal": {
      "code": "ideal",
      "label": "iDEAL",
      "options": [
        {
          "key": "ABNANL2A",
          "label": "ABN Amro Bank"
        },
        {
          "key": "ASNBNL21",
          "label": "ASN Bank"
        },
        {
          "key": "BUNQNL2A",
          "label": "bunq"
        },
        {
          "key": "INGBNL2A",
          "label": "ING"
        },
        {
          "key": "KNABNL2H",
          "label": "Knab"
        },
        {
          "key": "RABONL2U",
          "label": "Rabobank"
        },
        {
          "key": "RBRBNL21",
          "label": "RegioBank"
        },
        {
          "key": "SNSBNL2A",
          "label": "SNS Bank"
        },
        {
          "key": "TRIONL2U",
          "label": "Triodos Bank"
        },
        {
          "key": "FVLBNL22",
          "label": "Van Lanschot Bankiers"
        }
      ]
    },
    "sofortbanking": {
      "code": "sofortbanking",
      "label": "SofortBanking"
    },
    "cryptocurrency": {
      "key": "cryptocurrency",
      "label": "Cryptocurrency",
      "options": [
        {
          "key": "BTC",
          "label": "Bitcoin"
        }
      ]
    }
  }
}
Sample request
var http = require("https");

var options = {
  "method": "GET",
  "hostname": [
    "wallet",
    "getadcoin",
    "com"
  ],
  "path": [
    "api",
    "paymentmethods"
  ],
  "headers": {}
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
Sample response
{
  "paymentMethods": {
    "mistercash": {
      "code": "mistercash",
      "label": "Bancontact"
    },
    "giropay": {
      "code": "giropay",
      "label": "GiroPay"
    },
    "ideal": {
      "code": "ideal",
      "label": "iDEAL",
      "options": [
        {
          "key": "ABNANL2A",
          "label": "ABN Amro Bank"
        },
        {
          "key": "ASNBNL21",
          "label": "ASN Bank"
        },
        {
          "key": "BUNQNL2A",
          "label": "bunq"
        },
        {
          "key": "INGBNL2A",
          "label": "ING"
        },
        {
          "key": "KNABNL2H",
          "label": "Knab"
        },
        {
          "key": "RABONL2U",
          "label": "Rabobank"
        },
        {
          "key": "RBRBNL21",
          "label": "RegioBank"
        },
        {
          "key": "SNSBNL2A",
          "label": "SNS Bank"
        },
        {
          "key": "TRIONL2U",
          "label": "Triodos Bank"
        },
        {
          "key": "FVLBNL22",
          "label": "Van Lanschot Bankiers"
        }
      ]
    },
    "sofortbanking": {
      "code": "sofortbanking",
      "label": "SofortBanking"
    },
    "cryptocurrency": {
      "key": "cryptocurrency",
      "label": "Cryptocurrency",
      "options": [
        {
          "key": "BTC",
          "label": "Bitcoin"
        }
      ]
    }
  }
}
Sample request
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://wallet.getadcoin.com/api/paymentmethods"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
Sample response
{
  "paymentMethods": {
    "mistercash": {
      "code": "mistercash",
      "label": "Bancontact"
    },
    "giropay": {
      "code": "giropay",
      "label": "GiroPay"
    },
    "ideal": {
      "code": "ideal",
      "label": "iDEAL",
      "options": [
        {
          "key": "ABNANL2A",
          "label": "ABN Amro Bank"
        },
        {
          "key": "ASNBNL21",
          "label": "ASN Bank"
        },
        {
          "key": "BUNQNL2A",
          "label": "bunq"
        },
        {
          "key": "INGBNL2A",
          "label": "ING"
        },
        {
          "key": "KNABNL2H",
          "label": "Knab"
        },
        {
          "key": "RABONL2U",
          "label": "Rabobank"
        },
        {
          "key": "RBRBNL21",
          "label": "RegioBank"
        },
        {
          "key": "SNSBNL2A",
          "label": "SNS Bank"
        },
        {
          "key": "TRIONL2U",
          "label": "Triodos Bank"
        },
        {
          "key": "FVLBNL22",
          "label": "Van Lanschot Bankiers"
        }
      ]
    },
    "sofortbanking": {
      "code": "sofortbanking",
      "label": "SofortBanking"
    },
    "cryptocurrency": {
      "key": "cryptocurrency",
      "label": "Cryptocurrency",
      "options": [
        {
          "key": "BTC",
          "label": "Bitcoin"
        }
      ]
    }
  }
}

GET /addresses

Get all AdCoin addresses

Sample request
curl --request GET \
  --url https://wallet.getadcoin.com/api/addresses
Sample response
{
  "addresses": [
    "AeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4"
  ],
  "hidden": [
    "AcZXFBs3jPLwqSFvmcG89homfEzu2Njoem"
  ]
}
Sample request
require 'uri'
require 'net/http'

url = URI("https://wallet.getadcoin.com/api/addresses")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
Sample response
{
  "addresses": [
    "AeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4"
  ],
  "hidden": [
    "AcZXFBs3jPLwqSFvmcG89homfEzu2Njoem"
  ]
}
Sample request
import requests

url = "https://wallet.getadcoin.com/api/addresses"

response = requests.request("GET", url)

print(response.text)
Sample response
{
  "addresses": [
    "AeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4"
  ],
  "hidden": [
    "AcZXFBs3jPLwqSFvmcG89homfEzu2Njoem"
  ]
}
Sample request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
 CURLOPT_URL => "https://wallet.getadcoin.com/api/addresses",
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
 echo "cURL Error #:" . $err;
} else {
 echo $response;
}
Sample response
{
  "addresses": [
    "AeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4"
  ],
  "hidden": [
    "AcZXFBs3jPLwqSFvmcG89homfEzu2Njoem"
  ]
}
Sample request
var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://wallet.getadcoin.com/api/addresses",
  "method": "GET",
  "headers": {}
}

$.ajax(settings).done(function (response) {
  console.log(response);
});
Sample response
{
  "addresses": [
    "AeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4"
  ],
  "hidden": [
    "AcZXFBs3jPLwqSFvmcG89homfEzu2Njoem"
  ]
}
Sample request
var http = require("https");

var options = {
  "method": "GET",
  "hostname": [
    "wallet",
    "getadcoin",
    "com"
  ],
  "path": [
    "api",
    "addresses"
  ],
  "headers": {}
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
Sample response
{
  "addresses": [
    "AeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4"
  ],
  "hidden": [
    "AcZXFBs3jPLwqSFvmcG89homfEzu2Njoem"
  ]
}
Sample request
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://wallet.getadcoin.com/api/addresses"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
Sample response
{
  "addresses": [
    "AeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4"
  ],
  "hidden": [
    "AcZXFBs3jPLwqSFvmcG89homfEzu2Njoem"
  ]
}

POST /addresses

Create new AdCoin address

Sample request
curl --request POST \
  --url https://wallet.getadcoin.com/api/addresses
Sample response
{
  "address": "AeCy55WtofiCtm21mg3cExiqyfXU2zJFqP"
}
Sample request
require 'uri'
require 'net/http'

url = URI("https://wallet.getadcoin.com/api/addresses")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body
Sample response
{
  "address": "AeCy55WtofiCtm21mg3cExiqyfXU2zJFqP"
}
Sample request
import requests

url = "https://wallet.getadcoin.com/api/addresses"

response = requests.request("POST", url)

print(response.text)
Sample response
{
  "address": "AeCy55WtofiCtm21mg3cExiqyfXU2zJFqP"
}
Sample request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
 CURLOPT_URL => "https://wallet.getadcoin.com/api/addresses",
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "POST",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
 echo "cURL Error #:" . $err;
} else {
 echo $response;
}
Sample response
{
  "address": "AeCy55WtofiCtm21mg3cExiqyfXU2zJFqP"
}
Sample request
var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://wallet.getadcoin.com/api/addresses",
  "method": "POST",
  "headers": {}
}

$.ajax(settings).done(function (response) {
  console.log(response);
});
Sample response
{
  "address": "AeCy55WtofiCtm21mg3cExiqyfXU2zJFqP"
}
Sample request
var http = require("https");

var options = {
  "method": "POST",
  "hostname": [
    "wallet",
    "getadcoin",
    "com"
  ],
  "path": [
    "api",
    "addresses"
  ],
  "headers": {}
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
Sample response
{
  "address": "AeCy55WtofiCtm21mg3cExiqyfXU2zJFqP"
}
Sample request
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://wallet.getadcoin.com/api/addresses"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
Sample response
{
  "address": "AeCy55WtofiCtm21mg3cExiqyfXU2zJFqP"
}

POST /payto

Pay AdCoin to address or email Address: Valid AdCoin address Email: Valid e-mail to pay AdCoin too Amount: Amount of AdCoin in float Note: Only one of "address" or "email" should be given

Sample request
curl --request POST \
  --url https://wallet.getadcoin.com/api/payment \
  --header 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  --form address=AeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4 \
  --form email=text@example.com \
  --form amount=20
Sample response
{
  "transaction": "461ee445734f4fac4a367131b3e6275e7ce7df9fcccc3281edcf2703e8d5a9b9"
}
Sample request
require 'uri'
require 'net/http'

url = URI("https://wallet.getadcoin.com/api/payment")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request.body = "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"address\"\r\n\r\nAeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"email\"\r\n\r\ntext@example.com\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"amount\"\r\n\r\n20\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--"

response = http.request(request)
puts response.read_body
Sample response
{
  "transaction": "461ee445734f4fac4a367131b3e6275e7ce7df9fcccc3281edcf2703e8d5a9b9"
}
Sample request
import requests

url = "https://wallet.getadcoin.com/api/payment"

payload = "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"address\"\r\n\r\nAeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"email\"\r\n\r\ntext@example.com\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"amount\"\r\n\r\n20\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--"
response = requests.request("POST", url, data=payload)

print(response.text)
Sample response
{
  "transaction": "461ee445734f4fac4a367131b3e6275e7ce7df9fcccc3281edcf2703e8d5a9b9"
}
Sample request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
 CURLOPT_URL => "https://wallet.getadcoin.com/api/payment",
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "POST",
 CURLOPT_POSTFIELDS => "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"address\"\r\n\r\nAeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"email\"\r\n\r\ntext@example.com\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"amount\"\r\n\r\n20\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--",
 CURLOPT_HTTPHEADER => array(
 "content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW"
 ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
 echo "cURL Error #:" . $err;
} else {
 echo $response;
}
Sample response
{
  "transaction": "461ee445734f4fac4a367131b3e6275e7ce7df9fcccc3281edcf2703e8d5a9b9"
}
Sample request
var form = new FormData();
form.append("address", "AeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4");
form.append("email", "text@example.com");
form.append("amount", "20");

var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://wallet.getadcoin.com/api/payment",
  "method": "POST",
  "headers": {},
  "processData": false,
  "contentType": false,
  "mimeType": "multipart/form-data",
  "data": form
}

$.ajax(settings).done(function (response) {
  console.log(response);
});
Sample response
{
  "transaction": "461ee445734f4fac4a367131b3e6275e7ce7df9fcccc3281edcf2703e8d5a9b9"
}
Sample request
var http = require("https");

var options = {
  "method": "POST",
  "hostname": [
    "wallet",
    "getadcoin",
    "com"
  ],
  "path": [
    "api",
    "payment"
  ],
  "headers": {}
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write("------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"address\"\r\n\r\nAeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"email\"\r\n\r\ntext@example.com\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"amount\"\r\n\r\n20\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--");
req.end();
Sample response
{
  "transaction": "461ee445734f4fac4a367131b3e6275e7ce7df9fcccc3281edcf2703e8d5a9b9"
}
Sample request
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://wallet.getadcoin.com/api/payment"

	payload := strings.NewReader("------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"address\"\r\n\r\nAeTJRy6saLLs4SHSHVmPYVTceweLVWyaS4\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"email\"\r\n\r\ntext@example.com\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"amount\"\r\n\r\n20\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--")

	req, _ := http.NewRequest("POST", url, payload)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
Sample response
{
  "transaction": "461ee445734f4fac4a367131b3e6275e7ce7df9fcccc3281edcf2703e8d5a9b9"
}

GET /balance

Get current AdCoin balance

Sample request
curl --request GET \
  --url https://wallet.getadcoin.com/api/balance
Sample response
{
  "balance": 1234
}
Sample request
require 'uri'
require 'net/http'

url = URI("https://wallet.getadcoin.com/api/balance")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
Sample response
{
  "balance": 1234
}
Sample request
import requests

url = "https://wallet.getadcoin.com/api/balance"

response = requests.request("GET", url)

print(response.text)
Sample response
{
  "balance": 1234
}
Sample request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
 CURLOPT_URL => "https://wallet.getadcoin.com/api/balance",
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
 echo "cURL Error #:" . $err;
} else {
 echo $response;
}
Sample response
{
  "balance": 1234
}
Sample request
var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://wallet.getadcoin.com/api/balance",
  "method": "GET",
  "headers": {}
}

$.ajax(settings).done(function (response) {
  console.log(response);
});
Sample response
{
  "balance": 1234
}
Sample request
var http = require("https");

var options = {
  "method": "GET",
  "hostname": [
    "wallet",
    "getadcoin",
    "com"
  ],
  "path": [
    "api",
    "balance"
  ],
  "headers": {}
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
Sample response
{
  "balance": 1234
}
Sample request
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://wallet.getadcoin.com/api/balance"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
Sample response
{
  "balance": 1234
}

GET /transactions

Get list of all transactions

Sample request
curl --request GET \
  --url https://wallet.getadcoin.com/api/transactions
Sample response
[
  {
    "address": "AVBhENG4xQ8yMXNp36f731qNWGsdZwzA6A",
    "category": "send",
    "amount": -30,
    "fee": 0,
    "confirmations": 792,
    "blockhash": "3900df4e8b437686cf30fb64667fbcba553fede0a8b2bf1ecc5dbca6c98a6b40",
    "blockindex": 31,
    "blocktime": 1515586376,
    "txid": "f3f42c35528ece21e58d0be01b6f80839c9ce466ffeb54c83b07c9c100fd2f9b",
    "normtxid": "890b5d999ce37ab542a1969c774a8d3d1347700b3d156f506768d046fd75bf6c",
    "time": 1515609935,
    "timereceived": 1515609935,
    "confirmed": true
  }
]
Sample request
require 'uri'
require 'net/http'

url = URI("https://wallet.getadcoin.com/api/transactions")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
Sample response
[
  {
    "address": "AVBhENG4xQ8yMXNp36f731qNWGsdZwzA6A",
    "category": "send",
    "amount": -30,
    "fee": 0,
    "confirmations": 792,
    "blockhash": "3900df4e8b437686cf30fb64667fbcba553fede0a8b2bf1ecc5dbca6c98a6b40",
    "blockindex": 31,
    "blocktime": 1515586376,
    "txid": "f3f42c35528ece21e58d0be01b6f80839c9ce466ffeb54c83b07c9c100fd2f9b",
    "normtxid": "890b5d999ce37ab542a1969c774a8d3d1347700b3d156f506768d046fd75bf6c",
    "time": 1515609935,
    "timereceived": 1515609935,
    "confirmed": true
  }
]
Sample request
import requests

url = "https://wallet.getadcoin.com/api/transactions"

response = requests.request("GET", url)

print(response.text)
Sample response
[
  {
    "address": "AVBhENG4xQ8yMXNp36f731qNWGsdZwzA6A",
    "category": "send",
    "amount": -30,
    "fee": 0,
    "confirmations": 792,
    "blockhash": "3900df4e8b437686cf30fb64667fbcba553fede0a8b2bf1ecc5dbca6c98a6b40",
    "blockindex": 31,
    "blocktime": 1515586376,
    "txid": "f3f42c35528ece21e58d0be01b6f80839c9ce466ffeb54c83b07c9c100fd2f9b",
    "normtxid": "890b5d999ce37ab542a1969c774a8d3d1347700b3d156f506768d046fd75bf6c",
    "time": 1515609935,
    "timereceived": 1515609935,
    "confirmed": true
  }
]
Sample request
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
 CURLOPT_URL => "https://wallet.getadcoin.com/api/transactions",
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
 echo "cURL Error #:" . $err;
} else {
 echo $response;
}
Sample response
[
  {
    "address": "AVBhENG4xQ8yMXNp36f731qNWGsdZwzA6A",
    "category": "send",
    "amount": -30,
    "fee": 0,
    "confirmations": 792,
    "blockhash": "3900df4e8b437686cf30fb64667fbcba553fede0a8b2bf1ecc5dbca6c98a6b40",
    "blockindex": 31,
    "blocktime": 1515586376,
    "txid": "f3f42c35528ece21e58d0be01b6f80839c9ce466ffeb54c83b07c9c100fd2f9b",
    "normtxid": "890b5d999ce37ab542a1969c774a8d3d1347700b3d156f506768d046fd75bf6c",
    "time": 1515609935,
    "timereceived": 1515609935,
    "confirmed": true
  }
]
Sample request
var settings = {
  "async": true,
  "crossDomain": true,
  "url": "https://wallet.getadcoin.com/api/transactions",
  "method": "GET",
  "headers": {}
}

$.ajax(settings).done(function (response) {
  console.log(response);
});
Sample response
[
  {
    "address": "AVBhENG4xQ8yMXNp36f731qNWGsdZwzA6A",
    "category": "send",
    "amount": -30,
    "fee": 0,
    "confirmations": 792,
    "blockhash": "3900df4e8b437686cf30fb64667fbcba553fede0a8b2bf1ecc5dbca6c98a6b40",
    "blockindex": 31,
    "blocktime": 1515586376,
    "txid": "f3f42c35528ece21e58d0be01b6f80839c9ce466ffeb54c83b07c9c100fd2f9b",
    "normtxid": "890b5d999ce37ab542a1969c774a8d3d1347700b3d156f506768d046fd75bf6c",
    "time": 1515609935,
    "timereceived": 1515609935,
    "confirmed": true
  }
]
Sample request
var http = require("https");

var options = {
  "method": "GET",
  "hostname": [
    "wallet",
    "getadcoin",
    "com"
  ],
  "path": [
    "api",
    "transactions"
  ],
  "headers": {}
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
Sample response
[
  {
    "address": "AVBhENG4xQ8yMXNp36f731qNWGsdZwzA6A",
    "category": "send",
    "amount": -30,
    "fee": 0,
    "confirmations": 792,
    "blockhash": "3900df4e8b437686cf30fb64667fbcba553fede0a8b2bf1ecc5dbca6c98a6b40",
    "blockindex": 31,
    "blocktime": 1515586376,
    "txid": "f3f42c35528ece21e58d0be01b6f80839c9ce466ffeb54c83b07c9c100fd2f9b",
    "normtxid": "890b5d999ce37ab542a1969c774a8d3d1347700b3d156f506768d046fd75bf6c",
    "time": 1515609935,
    "timereceived": 1515609935,
    "confirmed": true
  }
]
Sample request
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://wallet.getadcoin.com/api/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
Sample response
[
  {
    "address": "AVBhENG4xQ8yMXNp36f731qNWGsdZwzA6A",
    "category": "send",
    "amount": -30,
    "fee": 0,
    "confirmations": 792,
    "blockhash": "3900df4e8b437686cf30fb64667fbcba553fede0a8b2bf1ecc5dbca6c98a6b40",
    "blockindex": 31,
    "blocktime": 1515586376,
    "txid": "f3f42c35528ece21e58d0be01b6f80839c9ce466ffeb54c83b07c9c100fd2f9b",
    "normtxid": "890b5d999ce37ab542a1969c774a8d3d1347700b3d156f506768d046fd75bf6c",
    "time": 1515609935,
    "timereceived": 1515609935,
    "confirmed": true
  }
]