Introduction

General API Information

Base URL: https://api.ampmcx.com
All endpoints return a JSON object with “status” and “data” fields.
Time-based data is formatted in ascending order, i.e. oldest first, newest last.
Rate limit: 60 requests per minute

Server Status

curl --location --request GET 'https://api.ampmcx.com/api/v1/status'

import requests

url = "https://api.ampmcx.com/api/v1/status"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/status', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975561712,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": null
}

Fetch server status.

HTTP Request

GET /api/v1/status

Trading Pairs

Get All Trading Pairs

curl --location --request GET 'https://api.ampmcx.com/api/v1/trading-pairs'

import requests

url = "https://api.ampmcx.com/api/v1/trading-pairs"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/trading-pairs', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975653190,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "tradingPairs": [
      {
        "baseAssetPrecision": 6,
        "quoteAssetPrecision": 2,
        "orderTypes": ["LIMIT", "MARKET"],
        "pair": "BTC_USDT",
        "status": "TRADING",
        "baseAsset": "BTC",
        "baseAssetName": "Bitcoin",
        "quoteAsset": "USDT",
        "quoteAssetName": "Tether",
        "makerFee": 0.001,
        "takerFee": 0.001,
        "id": null
      },
      {
        "baseAssetPrecision": 5,
        "quoteAssetPrecision": 2,
        "orderTypes": ["LIMIT", "MARKET"],
        "pair": "ETH_USDT",
        "status": "TRADING",
        "baseAsset": "ETH",
        "baseAssetName": "Ethereum",
        "quoteAsset": "USDT",
        "quoteAssetName": "Tether",
        "makerFee": 0.001,
        "takerFee": 0.001,
        "id": null
      }
    ]
  }
}

Detailed information for each trading pair available.

HTTP Request

GET /api/v1/trading-pairs

Get a Specific Trading Pair

curl --location --request GET 'https://api.ampmcx.com/api/v1/trading-pairs/BTC_USDT'

import requests

url = "https://api.ampmcx.com/api/v1/trading-pairs/BTC_USDT"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/trading-pairs/BTC_USDT', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975664933,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "tradingPair": {
      "baseAssetPrecision": 6,
      "quoteAssetPrecision": 2,
      "orderTypes": ["LIMIT", "MARKET"],
      "pair": "BTC_USDT",
      "status": "TRADING",
      "baseAsset": "BTC",
      "baseAssetName": "Bitcoin",
      "quoteAsset": "USDT",
      "quoteAssetName": "Tether",
      "makerFee": 0.001,
      "takerFee": 0.001,
      "id": null
    }
  }
}

Detailed information for a given trading pair.

HTTP Request

GET api/v1/trading-pairs/:pair

Path Variables

Key	Type	Description
pair	String	Trading pair, e.g. BTC_USDT

Order Book

curl --location --request GET 'https://api.ampmcx.com/api/v1/orderbook/BTC_USDT?depth=100'

import requests

url = "https://api.ampmcx.com/api/v1/orderbook/BTC_USDT?depth=100"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch(
  'https://api.ampmcx.com/api/v1/orderbook/BTC_USDT?depth=100',
  requestOptions
)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975674001,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "tradingPair": "BTC_USDT",
    "bids": [
      [30025, 0.5],
      [30023.5, 18]
    ],
    "asks": [
      [30028, 2],
      [30030, 25]
    ]
  }
}

Order book for a given trading pair.

HTTP Request

GET /api/v1/orderbook/:trading_pair

Path Variables

Key	Type	Description
trading_pair	String	Trading pair, eg. BTC_USDT

Query Parameters

Key	Type	Required	Description
depth	Integer	False	Valid values: [5, 10, 20, 50, 100, 500], default: 100, max: 500

Trades

curl --location --request GET 'https://api.ampmcx.com/api/v1/trades/BTC_USDT?limit=500'

import requests

url = "https://api.ampmcx.com/api/v1/trades/BTC_USDT?limit=500"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/trades/BTC_USDT?limit=500', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975683842,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "tradingPair": "BTC_USDT",
    "trades": [
      {
        "_id": "6013535b19de670f12e83b67",
        "price": 30011,
        "baseVol": 0.02,
        "quoteVol": 600.22,
        "taker": "BUY",
        "timestamp": "2021-01-29T00:14:19.192Z",
        "id": "6013535b19de670f12e83b67"
      },
      {
        "_id": "6013536f19de670f12e83b6a",
        "price": 30015,
        "baseVol": 0.1,
        "quoteVol": 3001.5,
        "taker": "BUY",
        "timestamp": "2021-01-29T00:14:39.832Z",
        "id": "6013536f19de670f12e83b6a"
      }
    ]
  }
}

Recently completed trades for a given trading pair.

HTTP Request

GET /api/v1/trades/:trading_pair

Path Variables

Key	Type	Description
trading_pair	String	Trading pair, eg. BTC_USDT

Query Parameters

Key	Type	Required	Description
limit	Integer	False	Default: 500, max: 1000

Aggregated Trades

curl --location --request GET 'https://api.ampmcx.com/api/v1/agg-trades/BTC_USDT?start=1611878679832&end=1611879279832&limit=500'

import requests

url = "https://api.ampmcx.com/api/v1/agg-trades/BTC_USDT?start=1611878679832&end=1611879279832&limit=500"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch(
  'https://api.ampmcx.com/api/v1/agg-trades/BTC_USDT?start=1611878679832&end=1611879279832&limit=500',
  requestOptions
)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975696673,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "tradingPair": "BTC_USDT",
    "aggTrades": [
      {
        "price": 30021,
        "baseVol": 0.1,
        "quoteVol": 3002.1,
        "taker": "BUY",
        "firstTradeID": "5fd088d7c8b0e29c76ef359c",
        "lastTradeID": "5fd0885bc8b0e29c76ef359b",
        "timestamp": "2021-1-29T00:04:40.197Z"
      },
      {
        "price": 30025,
        "baseVol": 0.04,
        "quoteVol": 1201,
        "taker": "BUY",
        "firstTradeID": "5fd08817c8b0e29c76ef359a",
        "lastTradeID": "5fd08817c8b0e29c76ef359a",
        "timestamp": "2021-1-29T00:04:41.199Z"
      }
    ]
  }
}

Aggregated trades for a given trading pair that fill at the same time, from the same order, with the same price.

HTTP Request

GET /api/v1/agg-trades/:trading_pair

Path Variables

Key	Type	Description
trading_pair	String	Trading pair, eg. BTC_USDT

Query Parameters

Key	Type	Required	Description
start	Integer	False	Unix timestamp in ms, inclusive
end	Integer	False	Unix timestamp in ms, inclusive, max: 1 hour from start
limit	Integer	False	Default: 500, max: 1000

Candle

curl --location --request GET 'https://api.ampmcx.com/api/v1/candle/BTC_USDT?interval=1m&start=1611878679832&end=1611879279832&limit=500'

import requests

url = "https://api.ampmcx.com/api/v1/candle/BTC_USDT?interval=1m&start=1611878679832&end=1611879279832&limit=500"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch(
  'https://api.ampmcx.com/api/v1/candle/BTC_USDT?interval=1m&start=1611878679832&end=1611879279832&limit=500',
  requestOptions
)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975706233,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "tradingPair": "BTC_USDT",
    "candle": [
      [
        "2021-01-29T00:04:00.000Z", // Open time
        30001, // Open
        30025, // High
        29998, // Low
        30015, // Close
        "2021-01-29T00:04:59.999Z", // Close time
        16, // Base asset volume
        480264, // Quote asset volume
        30, // Number of trades
        19.72, // Taker buy base asset volume
        591954.96 // Taker buy quote asset volume
      ],
      [
        "2021-01-29T00:05:00.000Z",
        30015,
        30056,
        30010,
        30022,
        "2021-01-29T00:05:59.999Z",
        22,
        660396,
        45,
        27.5,
        75027.5
      ]
    ]
  }
}

Candlestick data for a given trading pair and a given interval.

HTTP Request

GET /api/v1/candle/:trading_pair

Path Variables

Key	Type	Description
trading_pair	String	Trading pair, eg. BTC_USDT

Query Parameters

Key	Type	Required	Description
interval	String	True	Valid values: [‘1m’, ‘3m’, ‘5m’, ‘15m’, ‘30m’, ‘1h’, ‘2h’, ‘4h’, ‘6h’, ‘8h’, ‘12h’, ‘1d’, ‘3d’, ‘1w’, ‘1M’]
start	Integer	False	Unix timestamp in ms, inclusive
end	Integer	False	Unix timestamp in ms, inclusive
limit	Integer	False	Default: 500, max: 1000

Summary

Summary of All Trading Pairs

curl --location --request GET 'https://api.ampmcx.com/api/v1/summary'

import requests

url = "https://api.ampmcx.com/api/v1/summary"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/summary', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975740698,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "summary": [
      {
        "tradingPair": "BTC_USDT",
        "baseAsset": "BTC",
        "baseAssetName": "Bitcoin",
        "quoteAsset": "USDT",
        "quoteAssetName": "Tether",
        "lastPrice": 30128,
        "lastVol": 0.52,
        "highestBid": 30126,
        "lowestAsk": 30130,
        "openPrice": 30025,
        "highPrice": 30356,
        "lowPrice": 30083,
        "baseVol": 1854,
        "quoteVol": 55877706,
        "weightedAvgPrice": 30139,
        "priceChange": 103,
        "priceChangePercent": 0.34,
        "openTime": "2021-01-29T03:02:20.682Z",
        "closeTime": "2021-01-30T03:02:20.682Z",
        "firstTradeID": "5fd088ef25b0e29c76e10ae9",
        "lastTradeID": "5fd088ef25b0e29c76e54f7d",
        "count": 13500
      },
      {
        "tradingPair": "ETH_USDT",
        "baseAsset": "ETH",
        "baseAssetName": "Ethereum",
        "quoteAsset": "USDT",
        "quoteAssetName": "Tether",
        "lastPrice": 1306,
        "lastVol": 15,
        "highestBid": 1305,
        "lowestAsk": 1309,
        "openPrice": 1275,
        "highPrice": 1335,
        "lowPrice": 1253,
        "baseVol": 2004,
        "quoteVol": 2592508,
        "weightedAvgPrice": 1293.67,
        "priceChange": 31,
        "priceChangePercent": 2.37,
        "openTime": "2021-01-29T03:02:20.682Z",
        "closeTime": "2021-01-30T03:02:20.682Z",
        "firstTradeID": "5235feaf25b0e2925ab51528",
        "lastTradeID": "5235feaf25b0e2925abefa29",
        "count": 10510
      }
    ]
  }
}

Overview of market data for all tickers and all trading pairs.

HTTP Request

GET /api/v1/summary

Summary of a Specific Trading Pair

curl --location --request GET 'https://api.ampmcx.com/api/v1/summary/BTC_USDT'

import requests

url = "https://api.ampmcx.com/api/v1/summary/BTC_USDT"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/summary/BTC_USDT', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975750726,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "summary": {
      "tradingPair": "BTC_USDT",
      "baseAsset": "BTC",
      "baseAssetName": "Bitcoin",
      "quoteAsset": "USDT",
      "quoteAssetName": "Tether",
      "lastPrice": 30136,
      "lastVol": 0.46,
      "highestBid": 30133,
      "lowestAsk": 30140,
      "openPrice": 30030,
      "highPrice": 30356,
      "lowPrice": 30083,
      "baseVol": 1851,
      "quoteVol": 55787337,
      "weightedAvgPrice": 30139.03,
      "priceChange": 106,
      "priceChangePercent": 0.35,
      "openTime": "2021-01-29T03:02:30.710Z",
      "closeTime": "2021-01-30T03:02:30.710Z",
      "firstTradeID": "5fd088ef25b0e29c76e10bf3",
      "lastTradeID": "5fd088ef25b0e29c76e551a0",
      "count": 13488
    }
  }
}

Overview of market data for a given trading pair.

HTTP Request

GET /api/v1/summary/:trading_pair

Path Variables

Key	Type	Description
trading_pair	String	Trading pair, eg. BTC_USDT

Ticker

Get All Tickers

curl --location --request GET 'https://api.ampmcx.com/api/v1/ticker'

import requests

url = "https://api.ampmcx.com/api/v1/ticker"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/ticker', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975759177,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "ticker": [
      {
        "tradingPair": "BTC_USDT",
        "lastPrice": 30185,
        "baseVol": 1872,
        "quoteVol": 56451096,
        "status": "TRADING"
      },
      {
        "tradingPair": "ETH_USDT",
        "lastPrice": 1311,
        "baseVol": 2012,
        "quoteVol": 2630690,
        "status": "TRADING"
      }
    ]
  }
}

Last price and 24-hour volume summary for each trading pair.

HTTP Request

GET /api/v1/ticker

Get a Specific Ticker

curl --location --request GET 'https://api.ampmcx.com/api/v1/ticker/BTC_USDT'

import requests

url = "https://api.ampmcx.com/api/v1/ticker/BTC_USDT"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/ticker/BTC_USDT', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975808276,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "ticker": {
      "tradingPair": "BTC_USDT",
      "lastPrice": 30187,
      "baseVol": 1869,
      "quoteVol": 56450183,
      "status": "TRADING"
    }
  }
}

Last price and 24-hour volume summary for a given trading pair.

HTTP Request

GET /api/v1/ticker/:trading_pair

Path Variables

Key	Type	Description
trading_pair	String	Trading pair, eg. BTC_USDT

Book Ticker

Get All Book Tickers

curl --location --request GET 'https://api.ampmcx.com/api/v1/book-ticker'

import requests

url = "https://api.ampmcx.com/api/v1/book-ticker"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/book-ticker', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611975888999,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "bookTicker": [
      {
        "tradingPair": "BTC_USDT",
        "highestBid": 30180,
        "bidVol": 0.5,
        "lowestAsk": 30200,
        "askVol": 20
      },
      {
        "tradingPair": "ETH_USDT",
        "highestBid": 1306,
        "bidVol": 15,
        "lowestAsk": 1315,
        "askVol": 23
      }
    ]
  }
}

Best price and volume for each trading pair.

HTTP Request

GET /api/v1/book-ticker

Get a Specific Book Ticker

curl --location --request GET 'https://api.ampmcx.com/api/v1/book-ticker/BTC_USDT'

import requests

url = "https://api.ampmcx.com/api/v1/book-ticker/BTC_USDT"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/book-ticker/BTC_USDT', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611976008066,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "bookTicker": {
      "tradingPair": "BTC_USDT",
      "highestBid": 30175,
      "bidVol": 0.35,
      "lowestAsk": 30165,
      "askVol": 1.2
    }
  }
}

Best price and volume for a given trading pair.

HTTP Request

GET /api/v1/book-ticker/:trading_pair

Path Variables

Key	Type	Description
trading_pair	String	Trading pair, eg. BTC_USDT

Assets

Get All Assets

curl --location --request GET 'https://api.ampmcx.com/api/v1/assets'

import requests

url = "https://api.ampmcx.com/api/v1/assets"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/assets', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611976189866,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "assets": [
      {
        "symbol": "BTC",
        "name": "Bitcoin",
        "blockchain": [
          {
            "isDefault": true,
            "assetPrecision": 8,
            "canDeposit": true,
            "canWithdraw": true,
            "blockchain": "BTC",
            "name": "BTC",
            "addressRegex": "^bc1[a-zA-HJ-NP-Z0-9]{39,59}$",
            "minDeposit": 0.001,
            "minWithdraw": 0.001,
            "maxWithdraw": 0,
            "depositFee": 0,
            "withdrawalFee": 0,
            "feeAsset": "BTC",
            "confirmations": 2,
            "avgWaitTime": 30,
            "id": null
          }
        ],
        "id": null
      },
      {
        "symbol": "ETH",
        "name": "Ethereum",
        "blockchain": [
          {
            "isDefault": true,
            "assetPrecision": 8,
            "canDeposit": true,
            "canWithdraw": true,
            "blockchain": "ETH",
            "name": "ETH",
            "addressRegex": "^0x[a-fA-F0-9]{40}$",
            "minDeposit": 0.05,
            "minWithdraw": 0.05,
            "maxWithdraw": 0,
            "depositFee": 0,
            "withdrawalFee": 0,
            "feeAsset": "ETH",
            "confirmations": 12,
            "avgWaitTime": 15,
            "id": null
          }
        ],
        "id": null
      }
    ]
  }
}

Detailed information for each asset available.

HTTP Request

GET /api/v1/assets

Get a Specific Asset

curl --location --request GET 'https://api.ampmcx.com/api/v1/assets/BTC'

import requests

url = "https://api.ampmcx.com/api/v1/assets/BTC"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const requestOptions = {
  method: 'GET',
  redirect: 'follow',
};

fetch('https://api.ampmcx.com/api/v1/assets/BTC', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.log('error', error));

{
  "status": {
    "timestamp": 1611976175048,
    "success": true,
    "statusCode": 200,
    "errorMessage": null
  },
  "data": {
    "asset": {
      "symbol": "BTC",
      "name": "Bitcoin",
      "blockchain": [
        {
          "isDefault": true,
          "assetPrecision": 8,
          "canDeposit": true,
          "canWithdraw": true,
          "blockchain": "BTC",
          "name": "BTC",
          "addressRegex": "^bc1[a-zA-HJ-NP-Z0-9]{39,59}$",
          "minDeposit": 0.001,
          "minWithdraw": 0.001,
          "maxWithdraw": 0,
          "depositFee": 0,
          "withdrawalFee": 0,
          "feeAsset": "BTC",
          "confirmations": 2,
          "avgWaitTime": 30,
          "id": null
        }
      ],
      "id": null
    }
  }
}

Detailed information for a given asset.

HTTP Request

GET /api/v1/assets/:asset

Path Variables

Key	Type	Description
asset	String	Asset symbol, eg. BTC