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

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

HTTPcURLJavaScriptPython

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-05-16T06:08:07.853Z"
}

{
  "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-05-16T06:08:07.853Z"
}