Transactions
Authorizations
Body
externalIdany ofOptional
External transaction ID
string · min: 1Optional
nullOptional
amountnumberRequired
Transfer amount
assetall ofRequired
Information about network and currency in which transaction was made
assetFormatany ofOptional
Name of venue, in format of which network and currency are transmitted
string · min: 1Optional
nullOptional
sourceAddressesstring[] · min: 1Required
Sender's wallet addresses
destinationAddressstring · min: 1Required
Recipient's wallet address
txHashany ofOptional
Unique hash or identifier on the network
string · min: 1Optional
nullOptional
payloadobject · PayloadOptional
Transaction payload to help identify sender and recipient
feeany ofOptional
Network fee information
or
nullOptional
venueany ofOptional
Information about venue where transaction came from
or
nullOptional
createdAtstring · date-timeRequired
Date and time of transaction
Responses
200
Successful Response
application/json
400
Bad request or unknown source or destination addresses
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
422
Validation Error
application/json
post
POST //api/v1/transactions HTTP/1.1
Host: api.finchguard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 324
{
"externalId": "text",
"amount": 1,
"asset": {
"network": "text",
"currency": "text"
},
"assetFormat": "text",
"sourceAddresses": [
"text"
],
"destinationAddress": "text",
"txHash": "text",
"payload": {},
"fee": {
"amount": 1,
"currency": "text"
},
"venue": {
"name": "text",
"accountId": "text",
"transactionId": "text"
},
"createdAt": "2025-06-27T08:33:45.242Z"
}
{
"uid": "123e4567-e89b-12d3-a456-426614174000",
"externalId": "text",
"sourceAddressUid": "123e4567-e89b-12d3-a456-426614174000",
"destinationAddressUid": "123e4567-e89b-12d3-a456-426614174000",
"type": "internal",
"direction": "incoming",
"amount": 1,
"asset": {
"uid": "123e4567-e89b-12d3-a456-426614174000",
"network": "text",
"currency": "text"
},
"txHash": "text",
"sourceAddresses": [
"text"
],
"destinationAddress": "text",
"fee": {
"amount": 1,
"currency": "text"
},
"venue": {
"name": "text",
"accountId": "text",
"transactionId": "text"
},
"createdAt": "2025-06-27T08:33:45.242Z"
}
Last updated