Transactions

Push Transaction

post

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

externalIdany ofOptional

External transaction ID

string · min: 1Optional

or

nullOptional

amountnumberRequired

Transfer amount

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

uidstring · uuidRequired

Internal transaction UID

externalIdany ofRequired

External transaction ID

stringOptional

or

nullOptional

sourceAddressUidstring · uuidRequired

Sender's address UID

destinationAddressUidstring · uuidRequired

Recipient's address UID

typeall ofRequired

Transaction type (internal - between self addresses; external - between self and counterparty addresses)

string · enumOptionalPossible values:

directionall ofRequired

Transaction direction

string · enumOptionalPossible values:

amountnumberRequired

Transfer amount

txHashany ofRequired

Unique hash or identifier on the network

stringOptional

or

nullOptional

sourceAddressesstring[]Required

Sender's wallet addresses

destinationAddressstringRequired

Recipient's wallet address

feeany ofRequired

Network fee information

or

nullOptional

venueany ofRequired

Information about venue where transaction came from

or

nullOptional

createdAtstring · date-timeRequired

Date and time of transaction

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

/api/v1/transactions

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": "2026-03-02T20:37:28.743Z"
}

{
  "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": "2026-03-02T20:37:28.743Z"
}