Create auto-withdrawal

The method create auto-withdrawal request

Amount limits apply to creation:

• the amount must be more than $20 in equivalent

• the amount must be twice the commission of the network of the final coin/network (see the method of obtaining available coins)

Description of the request parameters

Parameter	Type	Required	Description
address	string	yes	Destination address
currency	string	yes	The coin you want to receive
network	string	yes	The network where you want to receive coins
amountFrom	string	no	Outgoing amount
amountTo	string	no	The final amount
feeInAmount	boolean	no	Include the network commission in the swap amount
webhookUrl	string	no	URL for sending notifications when the status changes

It is necessary to send one of the parameters: amountFrom or amountTo When specifying two parameters, the priority will be amountFrom

Include the network's commission in the swap amount

By specifying the feeInAmount parameter in the value true, the specified amount + network commission will be debited from the address

• If you specify amountFrom, the final amount amountTo may slip (it may differ from the one specified after the creation request)

• If you specify amountTo, the estimated amount of the debit from the address will be blocked + a percentage to cover the insurance of slippage. After the exchange is completed, the amount will be corrected to the amount that was spent for the swap. There may be a slight slippage (≈ 0.1%) of the final amount due to the imposition of swap filters on the amount to be received

Create auto-withdrawal

POSThttps://ocp.onchainpay.io/api-gateway/auto-withdrawals/create

Header parameters

Body

application/json

address*string

The address to receive

Example: "1CGuTUAx7icKniPVKGiyiT7QLycpkxULLP"

currency*string

The coin you want to receive

Example: "BTC"

network*string

The network where you want to receive coins

Example: "bitcoin"

amountFromstring

Outgoing amount

Example: "1000"

amountTostring

The final amount

Example: "0.1"

feeInAmountboolean

To include the network commission in the amount to swap, when specifying this parameter, the amountTo will be equal to the amount that the address will receive

webhookUrlstring

URL for sending a status change notification

Example: "https://merchant.domain/webhooks/..."

Response

200

Body

application/json

success*boolean

Request success indicator

response*AutoWithdrawal (object)

Request

JavaScriptCurlPython

const response = await fetch('https://ocp.onchainpay.io/api-gateway/auto-withdrawals/create', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "address": "1CGuTUAx7icKniPVKGiyiT7QLycpkxULLP",
      "currency": "BTC",
      "network": "bitcoin"
    }),
});
const data = await response.json();

Response

200

{
  "success": false,
  "response": {
    "id": "fe18920f-b5c3-495c-a1a8-54baebd0021a",
    "organizationId": "71404933-b068-4a05-9827-98e0554cbca3",
    "type": "WITHDRAWAL",
    "status": "PENDING",
    "message": null,
    "addressRiskLevel": "Low",
    "currencyFrom": "USDT",
    "networkFrom": "bsc",
    "currencyTo": "BTC",
    "networkTo": "bitcoin",
    "addressFromId": "25a8de42-a359-47f1-bb82-bc9f6c20f1b9",
    "addressFrom": "0xD65D24ABCd85165a243C33Cf8133ffBaaa98255D",
    "addressTo": "0x22aECc7ff5b435E38be5457C8538256918783F67",
    "amountFrom": "1000",
    "amountFromUSD": "1000",
    "amountTo": "0.1",
    "amountToUSD": "990",
    "amountToReceive": "0.999",
    "rate": "10000",
    "blockchainFeeFrom": "0.34",
    "blockchainFeeFromUSD": "0.34",
    "blockchainFeeToSource": "ADVANCED",
    "blockchainFeeTo": "0.001",
    "blockchainFeeToUSD": "10",
    "serviceFee": "10",
    "txId": "0xadcc95b8bcd123e41612c46b057df889e32a73297e973c21e8b38046ac04130a",
    "webhookUrl": "https://merchant.domain/webhooks/...",
    "createdAt": "2024-09-24T12:08:44.663Z",
    "updatedAt": "2024-09-24T12:08:44.663Z"
  }
}