Buy (Fiat On-Ramp)

These endpoints are used to get exchange rates and initiate buy orders on the Axis API

The minimum Stable Coin buy is $10 (USDT, USDC, E-USDT).

Exchange Rate

This endpoint is used to get both buy and sell rates between the fiat and crypto pair e.g. NGN-> USDT or USDT->NGN.

This endpoint is used to get the exchange rate

POST https://exchanger-api.fuspay.finance/api/v1/no-auth/Axis/ExchangeRate/

Headers

Name	Type	Description
Authorization*	String	Bearer ${partner_secret_key}
Content-Type*	String	application/json
x-partner-id*	String	Your partner ID eg. p602xxx

Request Body

Name	Type	Description
fiat*	String	this is the fiat of the currency pair eg "NGN"

Request Body

// Sample body request

{
    "fiat":"NGN",
    "chain": "usdt-trc"
}

Response

200: OK successful response

{
     success: true,
     message: string,
     data: {
        "NGN/USDT": 1700,
        "USDT/NGN": 1670
     }
}

"FIAT(NGN)/STABLE_COIN(USDT)": "This notation means you are buying the stable coin at the rate shown"

"STABLE_COIN(USDT)/FIAT(NGN)": "This notation means you are selling the fiat at the rate shown"

Create Buy Order Endpoint

This is used to initiate a new buy order. The life cycle of the order is encapsulated in three (3) events as seen below

POST https://exchanger-api.fuspay.finance/api/v1/no-auth/Axis/BuyUsdtWithFiat/

All events will be communicated to the callback registered in the post request.

Event request body will be updated as buy order progresses through the following phases:

a. event.buy.init (buy order started, awaiting fiat payment)

b. event.buy.received.fiat (fiat payment received)

c. event.buy.credited.crypto (transaction completed)

d. event.buy.error (error occurred)

Event body is signed with sha 512. sha512(body, public_key+secret_key)

The diagram below shows the complete flow of a buy order

Axis Swap API Flow-BUY.pdf

PDF · 2MB

Open

The event body is right below. to show the data structure that should be expected.

Axis does not handle third party on-ramp orders. i.e . The name of the user the payer bank account has to pass 66% name match with the user's KYC name on Axis. All transactions that faill this test will be pending. See the "Pending Transactions" side bar for more information