ShowcaseQuickstartTutorialsAPI Reference

Market Rates v2

List all default exchange rates

Returns all default exchange rates for all configured markets.

Query Parameters:

  • region (optional) Client's region, which is PH by default

For PH region: https://quote.coins.ph/v2/markets
For TH region: https://quote.coins.ph/v2/markets?region=TH

{
    markets: [
    {
        symbol: "BTC-USD",
        currency: "USD",
        product: "BTC",
        bid: "11357.06",
        ask: "11691.87",
        expires_in_seconds: 30
    },
    {
        symbol: "XRP-PHP",
        currency: "PHP",
        product: "XRP",
        bid: "12.84",
        ask: "13.01",
        expires_in_seconds: 30
    },
    {
        symbol: "BTC-HKD",
        currency: "HKD",
        product: "BTC",
        bid: "88414.00",
        ask: "91099.88",
        expires_in_seconds: 30
    },
    {
        symbol: "BCH-PHP",
        currency: "PHP",
        product: "BCH",
        bid: "12691.41",
        ask: "13230.13",
        expires_in_seconds: 30
    },
    {
        symbol: "ETH-PHP",
        currency: "PHP",
        product: "ETH",
        bid: "18294.36",
        ask: "19066.74",
        expires_in_seconds: 30
    },
    {
        symbol: "BTC-BCH",
        currency: "BCH",
        product: "BTC",
        bid: "42.41034780",
        ask: "44.21338748",
        expires_in_seconds: 30
    },
    {
        symbol: "USD-PHP",
        currency: "PHP",
        product: "USD",
        bid: "48.27",
        ask: "48.81",
        expires_in_seconds: 30
    },
    {
        symbol: "BTC-PHP",
        currency: "PHP",
        product: "BTC",
        bid: "550156.53",
        ask: "572469.86",
        expires_in_seconds: 30
    },
    {
        symbol: "BTC-IDR",
        currency: "IDR",
        product: "BTC",
        bid: "161982563",
        ask: "177051098",
        expires_in_seconds: 30
    },
    {
        symbol: "BTC-MYR",
        currency: "MYR",
        product: "BTC",
        bid: "47600.03",
        ask: "49046.04",
        expires_in_seconds: 30
    },
    {
        symbol: "BTC-TWD",
        currency: "TWD",
        product: "BTC",
        bid: "335014.11",
        ask: "345191.33",
        expires_in_seconds: 30
    },
    {
        symbol: "BTC-VND",
        currency: "VND",
        product: "BTC",
        bid: "262476933",
        ask: "270450579",
        expires_in_seconds: 30
    },
    {
        symbol: "BTC-XRP",
        currency: "XRP",
        product: "BTC",
        bid: "42388.290688",
        ask: "43197.089202",
        expires_in_seconds: 30
    },
    {
        symbol: "BTC-ETH",
        currency: "ETH",
        product: "BTC",
        bid: "29.433203680367358097",
        ask: "30.655979127180751129",
        expires_in_seconds: 30
    }
    ]
}

PROPERTIES

symbol - Market symbol, which is a unique identifier for the exchange rate.
currency - The currency to be exchanged to produce one unit of product.
product - The currency produced when the required amount of currency is exchanged.
bid - The price per unit when product is being exchanged for currency.
ask - The price per unit when currency is being exchanged for a product.
expires_in_seconds - The amount of seconds before the quote expires.

Get regular exchange rate

In order to get the exchange rate for a specific market symbol, you can also include the symbol on the path parameters of the request.

import requests

url = 'https://quote.coins.ph/v2/markets/BTC-PHP'

headers = {
    'Authorization': 'Bearer useraccesstoken'
    'Content-Type': 'application/json;charset=UTF-8',
    'Accept': 'application/json'
}

Sample response:

{
    symbol: "BTC-PHP",
    currency: "PHP",
    product: "BTC",
    bid: "550232.19",
    ask: "572792.20",
    expires_in_seconds: 30
}

Get exchange rate base on an amount or quantity

Coins.ph's market rates API also allows you to get the exchange rates based on a specified amount or quantity. However, this feature requires authentication.

This capability is only available to the new endpoint https://quote.coins.ph/v2/private_markets/

Parameters and properties from earlier examples are still relevant. To get the exchange rate for the provided symbol, a sample request would follow https://quote.coins.ph/v2/private_markets/BTC-PHP

Query Parameters:

  • quantity quantity of a product.
  • amount amount of currency.
  • region (optional) Client's region, which is PH by default

🚧

Important Notes

  1. Only one query parameter is allowed per request. The parameters quantity or amount should not both be used at the same time.

  2. Private Markets endpoint with the query parameters quantity or amount will only work if the symbol is included e.g https://quote.coins.ph/v2/private_markets/BTC-PHP?quantity=100.

A request with any of the query parameters - quantity or amount - without a specified symbol will yield the following result:

import requests

url = 'https://quote.coins.ph/v2/private_markets?quantity=100'

headers = {
    'Authorization': 'Bearer useraccesstoken'
    'Content-Type': 'application/json;charset=UTF-8',
    'Accept': 'application/json'
}

{
    symbol: "BTC-PHP",
    currency: "PHP",
    product: "BTC",
    bid: "550232.19",
    ask: "572792.20",
    expires_in_seconds: 30
}