Exchange rate API (version 2)¶

This module allows users to get exchange rate data

Quick reference¶

Resource	Operation	Description
Vietcombank (VCB)	GET /api/v2/exchange_rate/vcb	Get all Vietcombank (VCB) exchange rate
	POST /api/v2/exchange_rate/vcb	Post new exchange rate
Vietinbank (CTG)	GET /api/v2/exchange_rate/ctg	Get all Vietinbank (CTG) exchange rate
	POST /api/v2/exchange_rate/ctg	Post new exchange rate
Techcombank (TCB)	GET /api/v2/exchange_rate/tcb	Get all Techcombank (TCB) exchange rate
	POST /api/v2/exchange_rate/tcb	Post new exchange rate
BIDV	GET /api/v2/exchange_rate/bid	Get all BIDV exchange rate
	POST /api/v2/exchange_rate/bid	Post new exchange rate
Sacombank (STB)	GET /api/v2/exchange_rate/stb	Get all Sacombank (STB) exchange rate
	POST /api/v2/exchange_rate/stb	Post new exchange rate
SBV	GET /api/v2/exchange_rate/sbv	Get all SBV exchange rate
	POST /api/v2/exchange_rate/sbv	Post new exchange rate

Usage permission¶

To use this API, please self-request api_key at https://vapi.vnappmob.com/api/request_api_key?scope=exchange_rate

The api_key will be expired by default after 15 days

Details¶

GET /api/v2/exchange_rate/sbv¶

This function allows users to get the latest Ngân Hàng Nhà Nước (SBV) exchange rate

Request:

GET /api/v2/exchange_rate/sbv HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "results": [
        {
            "currency": "EUR",
            "buy": 25416.27,
            "sell": 26258.39
        },
        {
            "currency": "USD",
            "buy": 23130.00,
            "sell": 23250.00
        }...
    ]
}

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=0>

Response Headers

Content-Type – application/json

Status Codes

200 OK – OK
400 Bad Request – Error
403 Forbidden – Fail on authorization

POST /api/v2/exchange_rate/sbv¶

This function allows data manager to push newest data

Request:

POST /api/v2/exchange_rate/sbv HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 201 Created
Vary: Accept

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=1>
Content-Type – application/json

Request JSON Object

post_datas (List[json]) – List of json data with below params
currency (string) – currency code (3 chars: VND, USD…)
buy (float) – buy
sell (float) – sell

Status Codes

201 Created – Successful
400 Bad Request – Error
403 Forbidden – Fail on authorization

GET /api/v2/exchange_rate/vcb¶

This function allows users to get the latest Vietcombank (VCB) exchange rate

Request:

GET /api/v2/exchange_rate/vcb HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "results": [
        {
            "currency": "EUR",
            "buy_cash": 25416.27,
            "buy_transfer": 25492.75,
            "sell": 26258.39
        },
        {
            "currency": "USD",
            "buy_cash": 23130.00,
            "buy_transfer": 23130.00,
            "sell": 23250.00
        }...
    ]
}

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=0>

Response Headers

Content-Type – application/json

Status Codes

200 OK – OK
400 Bad Request – Error
403 Forbidden – Fail on authorization

POST /api/v2/exchange_rate/vcb¶

This function allows data manager to push newest data

Request:

POST /api/v2/exchange_rate/vcb HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 201 Created
Vary: Accept

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=1>
Content-Type – application/json

Request JSON Object

post_datas (List[json]) – List of json data with below params
currency (string) – currency code (3 chars: VND, USD…)
buy_cash (float) – buy_cash
buy_transfer (float) – buy_transfer
sell (float) – sell

Status Codes

201 Created – Successful
400 Bad Request – Error
403 Forbidden – Fail on authorization

GET /api/v2/exchange_rate/ctg¶

This function allows users to get the latest Vietinbank (CTG) exchange rate

Request:

GET /api/v2/exchange_rate/ctg HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "results": [
        {
            "currency": "EUR",
            "buy_cash": 25416.27,
            "buy_transfer": 25492.75,
            "sell": 26258.39
        },
        {
            "currency": "USD",
            "buy_cash": 23130.00,
            "buy_transfer": 23130.00,
            "sell": 23250.00
        }...
    ]
}

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=0>

Response Headers

Content-Type – application/json

Status Codes

200 OK – OK
400 Bad Request – Error
403 Forbidden – Fail on authorization

POST /api/v2/exchange_rate/ctg¶

This function allows data manager to push newest data

Request:

POST /api/v2/exchange_rate/ctg HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 201 Created
Vary: Accept

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=1>
Content-Type – application/json

Request JSON Object

post_datas (List[json]) – List of json data with below params
currency (string) – currency code (3 chars: VND, USD…)
buy_cash (float) – buy_cash
buy_transfer (float) – buy_transfer
sell (float) – sell

Status Codes

201 Created – Successful
400 Bad Request – Error
403 Forbidden – Fail on authorization

GET /api/v2/exchange_rate/tcb¶

This function allows users to get the latest Techcombank (TCB) exchange rate

Request:

GET /api/v2/exchange_rate/tcb HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "results": [
        {
            "currency": "EUR",
            "buy_cash": 25416.27,
            "buy_transfer": 25492.75,
            "sell": 26258.39
        },
        {
            "currency": "USD",
            "buy_cash": 23130.00,
            "buy_transfer": 23130.00,
            "sell": 23250.00
        }...
    ]
}

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=0>

Response Headers

Content-Type – application/json

Status Codes

200 OK – OK
400 Bad Request – Error
403 Forbidden – Fail on authorization

POST /api/v2/exchange_rate/tcb¶

This function allows data manager to push newest data

Request:

POST /api/v2/exchange_rate/tcb HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 201 Created
Vary: Accept

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=1>
Content-Type – application/json

Request JSON Object

post_datas (List[json]) – List of json data with below params
currency (string) – currency code (3 chars: VND, USD…)
buy_cash (float) – buy_cash
buy_transfer (float) – buy_transfer
sell (float) – sell

Status Codes

201 Created – Successful
400 Bad Request – Error
403 Forbidden – Fail on authorization

GET /api/v2/exchange_rate/bid¶

This function allows users to get the latest BIDV exchange rate

Request:

GET /api/v2/exchange_rate/bid HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "results": [
        {
            "currency": "EUR",
            "buy_cash": 25416.27,
            "buy_transfer": 25492.75,
            "sell": 26258.39
        },
        {
            "currency": "USD",
            "buy_cash": 23130.00,
            "buy_transfer": 23130.00,
            "sell": 23250.00
        }...
    ]
}

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=0>

Response Headers

Content-Type – application/json

Status Codes

200 OK – OK
400 Bad Request – Error
403 Forbidden – Fail on authorization

POST /api/v2/exchange_rate/bid¶

This function allows data manager to push newest data

Request:

POST /api/v2/exchange_rate/bid HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 201 Created
Vary: Accept

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=1>
Content-Type – application/json

Request JSON Object

post_datas (List[json]) – List of json data with below params
currency (string) – currency code (3 chars: VND, USD…)
buy_cash (float) – buy_cash
buy_transfer (float) – buy_transfer
sell (float) – sell

Status Codes

201 Created – Successful
400 Bad Request – Error
403 Forbidden – Fail on authorization

GET /api/v2/exchange_rate/stb¶

This function allows users to get the latest Sacombank (STB) exchange rate

Request:

GET /api/v2/exchange_rate/stb HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "results": [
        {
            "currency": "EUR",
            "buy_cash": 25416.27,
            "buy_transfer": 25492.75,
            "sell": 26258.39
        },
        {
            "currency": "USD",
            "buy_cash": 23130.00,
            "buy_transfer": 23130.00,
            "sell": 23250.00
        }...
    ]
}

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=0>

Response Headers

Content-Type – application/json

Status Codes

200 OK – OK
400 Bad Request – Error
403 Forbidden – Fail on authorization

POST /api/v2/exchange_rate/stb¶

This function allows data manager to push newest data

Request:

POST /api/v2/exchange_rate/stb HTTP/1.1
Host: https://vapi.vnappmob.com
Accept: application/json

Response:

HTTP/1.1 201 Created
Vary: Accept

Request Headers

Authorization – Bearer <api_key|scope=exchange_rate|permission=1>
Content-Type – application/json

Request JSON Object

post_datas (List[json]) – List of json data with below params
currency (string) – currency code (3 chars: VND, USD…)
buy_cash (float) – buy_cash
buy_transfer (float) – buy_transfer
sell (float) – sell

Status Codes

201 Created – Successful
400 Bad Request – Error
403 Forbidden – Fail on authorization