Transactions

Push Transaction

post
Authorizations
Body
externalIdany ofOptional

External transaction ID

string · min: 1Optional
or
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
or
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
or
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
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