Developer's Guide - Api

Overview

GuldenTrader provides a simple and powerful API to allow you to programatically perform nearly all actions you can from our web interface. All requests use the application/json content type and go over https. The base url is https://exchange.guldentrader.com/api/v1.0/{group}/{method}/{param1}/{param2}/.../{paramX}. All requests are GET requests and all responses come in a default response object with the result in the result field. Always check the success flag to ensure that your API call succeeded. If the call is not successful error message will be avaliable in message flag.

We are currently restricting orders to 500 open orders and 200,000 orders a day. We reserve the right to change these settings as we tune the system. If you are affected by these limits as an active trader, please email support@guldentrader.com.

If you have any questions, feedback or recommendation for API support you can post a question in our support center.

Getting Started

General

We provide a simple API. All calls are GETs and should be called via https. The endpoints have a standard format as follows:

https://exchange.guldentrader.com/api/v1.0/{group}/{method}/{param1}/{param2}/....../{paramX}

Authentication

In the spirit of keeping things simple, we offer an easy to manage API Key authentication method. You can have multiple API keys, each with their own level of rights. To manage your API keys please click on your Profile photo->Manage API Keys. Note, you MUST have 2fa enabled to create an API key for your own safety.


API Reference

Our APIs are broken into three distinct groups


Public Api

/public/getmarkets

Used to get the open and available trading markets at GuldenTrader along with other meta data.

Paremeters: None

Request:

https://exchange.guldentrader.com/api/v1.0/public/getmarkets

Responce

    {
        "success" : true,
        "result" : [{
                "MarketCurrency" : "NLG",
                "BaseCurrency" : "EUR",
                "MarketCurrencyLong" : "Gulden",
                "BaseCurrencyLong" : "Euro",
                "MinTradeSize" : 0.01000000,
                "MarketName" : "EUR-NLG",
                "IsActive" : true,
                "Created" : "2018-02-13 00:00:00"
            }, {
                "MarketCurrency" : "GTS",
                "BaseCurrency" : "EUR",
                "MarketCurrencyLong" : "GuldentraderShare",
                "BaseCurrencyLong" : "Euro",
                "MinTradeSize" : 100.00000000,
                "MarketName" : "EUR-GTS",
                "IsActive" : true,
                "Created" : "2018-02-13 00:00:00"
            }
        ]
    }
    

/public/getcurrencies

Used to get all supported currencies at GuldenTrader along with other meta data.

Parameters: None

Request:

https://exchange.guldentrader.com/api/v1.0/public/getcurrencies

Responce:

    {
    "success" : true,
    "result" : [{
            "Currency" : "EUR",
            "CurrencyLong" : "Euro",
            "MinConfirmation" : 2,
            "TxFee" : 0.00020000,
            "IsActive" : true,
            "CoinType" : "Euro",
            "BaseAddress" : null
        }, {
            "Currency" : "NLG",
            "CurrencyLong" : "Gulden",
            "MinConfirmation" : 5,
            "TxFee" : 0.00200000,
            "IsActive" : true,
            "CoinType" : "BITCOIN",
            "BaseAddress" : null
        }
    ]
    }
    

/public/getmarketsummaries

Used to get the last 24 hour summary of all active exchanges

Parametes: None

Request:

https://exchange.guldentrader.com/api/v1.0/public/getmarketsummaries

Responce:

    {
        "success" : true,
        "result" : [{
                "MarketName" : "EUR-NLG",
                "High" : 0.00000919,
                "Low" : 0.00000820,
                "Volume" : 74339.61396015,
                "Last" : 0.00000820,
                "BaseVolume" : 0.64966963,
                "TimeStamp" : "2018-07-09 07:19:30.15",
                "Bid" : 0.00000820,
                "Ask" : 0.00000831,
                "OpenBuyOrders" : 15,
                "OpenSellOrders" : 15,
                "PrevDay" : 0.00000821,
                "Created" : "2014-03-20T06:00:00",
                "DisplayMarketName" : null
            }, {
                "MarketName" : "EUR-XVG",
                "High" : 0.00000072,
                "Low" : 0.00000001,
                "Volume" : 166340678.42280999,
                "Last" : 0.00000005,
                "BaseVolume" : 17.59720424,
                "TimeStamp" : "2014-07-09T07:21:40.51",
                "Bid" : 0.00000004,
                "Ask" : 0.00000005,
                "OpenBuyOrders" : 18,
                "OpenSellOrders" : 18,
                "PrevDay" : 0.00000002,
                "Created" : "2014-05-30T07:57:49.637",
                "DisplayMarketName" : null
            }
        ]
    }
    

/public/getmarketsummary

Used to get the last 24 hour summary of all active exchanges

Parameters:

parameter required description
market required a string literal for the market (ex: EUR-NLG)

Request:

https://exchange.guldentrader.com/api/v1.0/public/getmarketsummary/EUR-NLG

Responce:

{
        "success" : true,
        "result" : [{
                "MarketName" : "EUR-NLG",
                "High" : 0.01350000,
                "Low" : 0.01200000,
                "Volume" : 3833.97619253,
                "Last" : 0.01349998,
                "BaseVolume" : 47.03987026,
                "TimeStamp" : "2018-07-09 07:22:16.72",
                "Bid" : 0.01271001,
                "Ask" : 0.01291100,
                "OpenBuyOrders" : 45,
                "OpenSellOrders" : 45,
                "PrevDay" : 0.01229501,
                "Created" : "2018-02-13 00:00:00",
                "DisplayMarketName" : null
            }
        ]
    }
    

/public/getticker

Used to get the current tick values for a market.

Parameters:

parameter required description
market required a string literal for the market (ex: EUR-NLG)

Request:

https://exchange.guldentrader.com/api/v1.0/public/getticker/EUR-NLG

Responce:

{
        "success" : true,
        "result" : {
            "Bid" : 2.05670368,
            "Ask" : 3.35579531,
            "Last" : 3.35579531
        }
    }
    

/public/getorderbook

Used to get retrieve the orderbook for a given market

Parameters:

parameter required description
market required a string literal for the market (ex: EUR-NLG)
type required buy, sell or both to identify the type of orderbook to return.

Request:

https://exchange.guldentrader.com/api/v1.0/public/getorderbook/EUR-NLG/both

Responce:

    {
        "success" : true,
        "result" : {
            "buy" : [{
                    "Quantity" : 12.37000000,
                    "Rate" : 0.02525000
                }
            ],
            "sell" : [{
                    "Quantity" : 32.55412402,
                    "Rate" : 0.02540000
                }, {
                    "Quantity" : 60.00000000,
                    "Rate" : 0.02550000
                }, {
                    "Quantity" : 60.00000000,
                    "Rate" : 0.02575000
                }, {
                    "Quantity" : 84.00000000,
                    "Rate" : 0.02600000
                }
            ]
        }
    }

    

/public/getmarkethistory

Used to retrieve the latest trades that have occured for a specific market.

Parameters:

parameter required description
market required a string literal for the market (ex: EUR-NLG)

Request:

https://exchange.guldentrader.com/api/v1.0/public/getmarkethistory/EUR-NLG

Responce:

    
    {
        "success" : true,
        "result" : [{
                "Id" : 319435,
                "TimeStamp" : "2014-07-09T03:21:20.08",
                "Quantity" : 0.30802438,
                "Price" : 0.01263400,
                "Total" : 0.00389158,
                "OrderType": "sell"
            }, {
                "Id" : 319433,
                "TimeStamp" : "2014-07-09T03:21:20.08",
                "Quantity" : 0.31820814,
                "Price" : 0.01262800,
                "Total" : 0.00401833,
                "OrderType": "buy"
            }
        ]
    }