Merchants
List Crypto Transfers
Query the full history of internal crypto transfers between merchant wallets, filterable by token symbol, date range, and client ID.
GET
/
v2
/
assets
/
internalTransferOrders
List Crypto Transfers
curl --request GET \
--url https://api-test.velafi.com/v2/assets/internalTransferOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/internalTransferOrders"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/assets/internalTransferOrders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/assets/internalTransferOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"id": "<string>",
"tokenId": "<string>",
"amount": "<string>",
"clientId": "<string>",
"merchantId": "<string>",
"fromMerchantId": "<string>",
"toMerchantId": "<string>"
}
]
}Use this endpoint to retrieve the history of internal crypto transfers involving one or more merchant wallets. Each completed transfer produces two records — a negative (debit) entry on the sender’s side and a positive (credit) entry on the recipient’s side. Use the
merchantId filter to scope results to a single merchant. Pair with the Crypto Transfer endpoint to build a complete audit trail.
All requests must include the
X-BH-TOKEN header with a business token from GET /v2/token/generate.Endpoint
GET https://api.velafi.com/v2/assets/internalTransferOrders
Query Parameters
number
Filter records by merchant ID.
string
Filter by token symbol, e.g.
USDT, BTC.string
Filter by your client-supplied transfer identifier.
number
Start of the date range as a Unix timestamp in milliseconds.
number
End of the date range as a Unix timestamp in milliseconds.
number
Number of records to return per page.
Response Fields
number
HTTP-style response code.
200 indicates success.string
Human-readable status message, e.g.
SUCCESS.array
Show data item fields
Show data item fields
string
Unique record ID for this transfer line.
string
Token symbol for this record.
string
Amount transferred. Negative = debit (sender), positive = credit (recipient).
string
Your client-supplied transfer identifier.
string
ID of the merchant this record belongs to.
string
Sender merchant ID.
string
Recipient merchant ID.
Example
cURL
curl -G https://api.velafi.com/v2/assets/internalTransferOrders \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "merchantId=246" \
--data-urlencode "tokenId=USDT" \
--data-urlencode "pageSize=10"
Response
{
"code": 200,
"msg": "SUCCESS",
"data": [
{
"id": "4355",
"tokenId": "USDT",
"amount": "10",
"clientId": "crypto-transfer-001",
"merchantId": "61",
"fromMerchantId": "246",
"toMerchantId": "61"
},
{
"id": "4354",
"tokenId": "USDT",
"amount": "-10",
"clientId": "crypto-transfer-001",
"merchantId": "246",
"fromMerchantId": "246",
"toMerchantId": "61"
}
]
}
A single transfer creates two records: one for the sender (negative
amount) and one for the recipient (positive amount). The merchantId field tells you which merchant’s perspective each record represents.Was this page helpful?
⌘I
List Crypto Transfers
curl --request GET \
--url https://api-test.velafi.com/v2/assets/internalTransferOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/internalTransferOrders"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/assets/internalTransferOrders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/assets/internalTransferOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"id": "<string>",
"tokenId": "<string>",
"amount": "<string>",
"clientId": "<string>",
"merchantId": "<string>",
"fromMerchantId": "<string>",
"toMerchantId": "<string>"
}
]
}