Buy/Sell Orders
Endpoints to process crypto exchange orders and retrieve their details.
If you are a neobank or fintech app, reach out to our team to activate the pool_balance features.
Create a New Order
POST https://live.betaapp.com/v1/order/exchange
Beta will freeze the quote for this order for 20 minutes.
If the User deposits a different amount/asset than requested or after this timeframe, our platform will automatically trigger workflows for the payer to top-up the remaining amount or receive a refund for its deposit.
Headers
Authorization*
String
Bearer {access_token}
x-sub-account-id*
String
subaccount ID
accept*
String
application/json
Request Body
source_asset*
String
Asset that user wants to provide in the transaction. It could be any Fiat or Crypto.
target_asset*
String
Asset that user wants to receive in the transaction. It could be any Fiat or Crypto.
network
String
Crypto network
source_amount
String
Amount that payer wants to deposit
pool_balance
Boolean
True or False.
target_amount
String
Amount that payer wants to receive
{
"amount": 0,
"asset": {
"large_image_url": "string",
"medium_image_url": "string",
"name": "string",
"small_image_url": "string",
"symbol": "string",
"type": "string"
},
"date_time": "string",
"deposit": true,
"exp_time": 0,
"message": "string",
"network": "string",
"tag": "string",
"wallet_address": "string"
}{
"message": "string"
}If Target Asset is a FIAT currency, it means the subaccount is selling crypto. However, if it is a CRYPTO asset, it means the subaccount is purchasing crypto.
Request Example:
Response Example:
Here is an example of how the New Order Response could be displayed on the Front-End.
Retrieve Order List
GET https://live.betaapp.com/v1/order
This endpoint retrieves the Order List of a specific subaccount_id.
Query Parameters
status
String
Parameters: open, pending, confirmed, canceled.
search
String
could be the e-mail or order description
order_by
String
Parameters: id, recipient_email, description, created_at, status
page*
Integer
Page number for this query
size*
integer
Number of items per page for this query
Headers
Authorization*
String
Bearer {access_token}
x-sub-account-id
String
Subaccount ID
accept*
String
application/json
Request Example:
Response Example:
Retrieve Order Details
GET https://live.betaapp.com/v1/orders/details/{id}
This endpoint provides the details of a specific payment.
Query Parameters
id*
String
Order ID
Headers
Authorization*
String
Bearer {access_token}
x-sub-account-id*
String
Your user's subaccount_id
accept*
String
application/json
Request Example:
Response Example:
Last updated