Get Started
Invoice
Invoice Flow
Balance
Rate
Exchange
Transfer

Exchange

First check the balance and then check the rate and try to exchange based on the rate.

exchange

POST https://api.zipay.io/api/exchange

Name	Type	Mandatory	Description
amount	float	yes	Amount 100.99
from_currency	string	yes	One of USD , USDT and IRT
to_currency	string	yes	One of USD , USDT and IRT

Response:

{
    "result": {
        "trackid": "3986770a-2e38-4a27-a7ce-5dbc804aaf79",
        "time": 1680165795,
        "date": "30/03/2023 08:43 UTC",
        "datew3c": "2023-03-30T08:43:15+00:00",
        "status": "completed",
        "spent_amount": "100.99",
        "spent_coin": {
            "name": "United States dollar",
            "currency": "USD",
            "symbol": "$"
        },
        "rate": "51889.25",
        "get_amount": "5240295.3575",
        "get_coin": {
            "name": "Toman",
            "currency": "IRT",
            "symbol": "IRT"
        },
        "market": "USDIRT",
        "side": "sell"
    },
    "success": true,
    "status": 200
}
    

---

Exchange List

POST https://api.zipay.io/api/exchange-list

Name	Type	Mandatory	Description
trackid	string	no	3986770a-2e38-4a27-a7ce-5dbc804aaf79
limit	integer	no	default is 10
page	integer	no	default is 1
sort	string	no	default is desc you can use asc

Response:

{
    "items": [
        {
            "trackid": "3986770a-2e38-4a27-a7ce-5dbc804aaf79",
            "time": 1680165795,
            "date": "30/03/2023 08:43 UTC",
            "datew3c": "2023-03-30T08:43:15+00:00",
            "status": "completed",
            "spent_amount": "100.99",
            "spent_coin": {
                "name": "United States dollar",
                "currency": "USD",
                "symbol": "$"
            },
            "rate": "51889.25",
            "get_amount": "5240295.3575",
            "get_coin": {
                "name": "Toman",
                "currency": "IRT",
                "symbol": "IRT"
            },
            "market": "USDIRT",
            "side": "sell"
        },
        {
            "trackid": "14807c68-36a8-4ae4-a796-d9c4c93f8595",
            "time": 1680118721,
            "date": "29/03/2023 19:38 UTC",
            "datew3c": "2023-03-29T19:38:41+00:00",
            "status": "completed",
            "spent_amount": "440590392.01",
            "spent_coin": {
                "name": "Toman",
                "currency": "IRT",
                "symbol": "IRT"
            },
            "rate": "53064",
            "get_amount": "8303.00000018845168098899",
            "get_coin": {
                "name": "United States dollar",
                "currency": "USD",
                "symbol": "$"
            },
            "market": "USDIRT",
            "side": "buy"
        },
        {
            "trackid": "f9d7e7a4-ec48-421c-a22e-b75d28933c5a",
            "time": 1680113307,
            "date": "29/03/2023 18:08 UTC",
            "datew3c": "2023-03-29T18:08:27+00:00",
            "status": "completed",
            "spent_amount": "12668.03",
            "spent_coin": {
                "name": "United States dollar",
                "currency": "USD",
                "symbol": "$"
            },
            "rate": "1.005",
            "get_amount": "12605.00497512437810945274",
            "get_coin": {
                "name": "USD Tether",
                "currency": "USDT",
                "symbol": "USDT"
            },
            "market": "USDTUSD",
            "side": "buy"
        }
    ],
    "total": 40,
    "limit": 3,
    "page": 1,
    "sort": "desc",
    "success": true,
    "status": 200
}