Creating USDT to PHP Transfers

This guide walks through the process of creating transfers from USDT to PHP using our Transfer API. The process involves two steps: requesting a quote and executing the transfer.

Prerequisites

Ensure you have:

  • A valid API key from us
  • Your API key set as an environment variable:
export API_KEY="your_api_key_here"

Quick Start

# 1. Get quote for USDT to PHP transfer
curl --request GET \
  --url "https://api.nxos.io/v1/service/transfer/quotes?base_asset=USDT&counter_asset=PHP&type=SELL" \
  --header "Authorization: Bearer ${API_KEY}"

# Example Response
{
  "quote_id": "qt_01HFXK2J...",
  "base_asset": "USDT",
  "counter_asset": "PHP",
  "exchange_rate": "56.25",
  "base_asset_tier": {
    "min_amount": "1000",
    "max_amount": "100000"
  },
  "expires_at": "2024-01-01T00:05:00Z"
}

Step-by-Step Guide

1. Request a Quote

First, fetch a quote to get current exchange rates and a quote_id:

curl --request GET \
  --url "https://api.nxos.io/v1/service/transfer/quotes" \
  --header "Authorization: Bearer ${API_KEY}" \
  --data-urlencode "base_asset=USDT" \
  --data-urlencode "counter_asset=PHP" \
  --data-urlencode "type=SELL"

Required Parameters:

  • base_asset: USDT
  • counter_asset: PHP
  • type: SELL (when converting from USDT to PHP)

2. Execute the Transfer

Once you have a quote, execute the transfer by submitting the beneficiary information in ISO20022 format:

curl --request POST \
  --url "https://api.nxos.io/v1/service/transfer" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${API_KEY}" \
  --data '{
    "transfer_ref": "tx_ref_123",
    "quote_id": "qt_01HFXK2J...",
    "value": {
      "amount": "10000", // 100.00 USDT
      "asset_code": "USDT"
    },
    "info": {
      "Cdtr": {
        "Nm": "Juan Dela Cruz",
        "StrdNm": {
          "Title": "Mr",
          "FirstNm": "Juan",
          "LastNm": "Dela Cruz"
        }
      },
      "CdtrAcct": {
        "Id": {
          "Othr": {
            "Id": "1234567890"  // Philippine bank account number
          }
        }
      },
      "CdtrAgt": {
        "FinInstnId": {
          "Othr": {
            "Id": "BOPI"  // Bank of the Philippine Islands code
          }
        }
      }
    }
  }'

Required Fields:

  • transfer_ref: Your unique reference for this transfer
  • quote_id: ID from the quote response
  • value: Transfer amount in USDT
  • info: Beneficiary details in ISO20022 format

Important Notes

  • Quotes expire after 5 minutes
  • Amount must be within the min_amount and max_amount specified in the quote
  • Beneficiary bank information must be valid Philippine bank details
  • All amounts should be string-formatted with 2 decimal places