Skip to main content
POST
/
api
/
v1
/
payments
/
estimate-outcome
{
  "amount": "2575000",
  "order_type": 1,
  "chain_id": 56,
  "token_address": "0x55d398326f99059ff775485246999027b3197955",
  "reverse": false,
  "buffer": 0.005
}
{
  "message": "success",
  "data": {
    "outcome": "100",
    "rate": 25750,
    "fee_vnd": 5000,
    "fees": {
      "service_fee": 5000,
      "min_fee": 2000
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://pay-docs.holdstation.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Partners can calculate the final amount for a given input amount and order type. Set reverse=true to calculate the required input amount for a desired outcome.
amount
string
required
Input amount to calculate. In VND for deposit orders, USD for withdrawal orders.
order_type
integer
required
Type of the order. 1 = Deposit, 2 = Withdrawal.
chain_id
integer
required
Blockchain network ID. See List Tokens.
token_address
string
required
Token contract address. See List Tokens.
reverse
boolean
required
If true, calculates the required input amount to achieve a desired outcome.
buffer
number
required
Optional buffer rate override (fractional). Effective buffer = max(override, configured). Example: 0.005 = 0.5%.
{
  "amount": "2575000",
  "order_type": 1,
  "chain_id": 56,
  "token_address": "0x55d398326f99059ff775485246999027b3197955",
  "reverse": false,
  "buffer": 0.005
}
{
  "message": "success",
  "data": {
    "outcome": "100",
    "rate": 25750,
    "fee_vnd": 5000,
    "fees": {
      "service_fee": 5000,
      "min_fee": 2000
    }
  }
}