Transactions

Push Transaction

POSThttps://api.finchguard.com//api/v1/transactions

Authorization

Authorization

Body

application/json

externalIdExternalid

External transaction ID

stringnull

amount*Amount

Transfer amount

asset*all of

Information about network and currency in which transaction was made

assetFormatAssetformat

Name of venue, in format of which network and currency are transmitted

stringnull

sourceAddresses*Sourceaddresses

Sender's wallet addresses

destinationAddress*Destinationaddress

Recipient's wallet address

txHashTxhash

Unique hash or identifier on the network

stringnull

payloadPayload

Transaction payload to help identify sender and recipient

feeany of

Network fee information

FeeItemnull

venueany of

Information about venue where transaction came from

VenueItemnull

createdAt*Createdat

Date and time of transaction

Response

200400401403422

Successful Response

Body

application/json

uid*Uid

Internal transaction UID

externalId*Externalid

External transaction ID

stringnull

sourceAddressUid*Sourceaddressuid

Sender's address UID

destinationAddressUid*Destinationaddressuid

Recipient's address UID

type*all of

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

direction*all of

Transaction direction

amount*Amount

Transfer amount

asset*all of

Information about network and currency in which transaction was made

txHash*Txhash

Unique hash or identifier on the network

stringnull

sourceAddresses*Sourceaddresses

Sender's wallet addresses

destinationAddress*Destinationaddress

Recipient's wallet address

fee*any of

Network fee information

FeeItemnull

venue*any of

Information about venue where transaction came from

VenueItemnull

createdAt*Createdat

Date and time of transaction

Request

JavaScriptCurlPython

const response = await fetch('https://api.finchguard.com//api/v1/transactions', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "amount": 0,
      "asset": {
        "network": "text",
        "currency": "text"
      },
      "sourceAddresses": [
        "text"
      ],
      "destinationAddress": "text",
      "createdAt": "2024-11-21T07:18:40.956Z"
    }),
});
const data = await response.json();

Response

200400401403422

{
  "uid": "123e4567-e89b-12d3-a456-426614174000",
  "externalId": "text",
  "sourceAddressUid": "123e4567-e89b-12d3-a456-426614174000",
  "destinationAddressUid": "123e4567-e89b-12d3-a456-426614174000",
  "type": {},
  "direction": {},
  "amount": 0,
  "asset": {
    "uid": "123e4567-e89b-12d3-a456-426614174000",
    "network": "text",
    "currency": "text"
  },
  "txHash": "text",
  "sourceAddresses": [
    "text"
  ],
  "destinationAddress": "text",
  "fee": {
    "amount": 0,
    "currency": "text"
  },
  "venue": {
    "name": "text",
    "accountId": "text",
    "transactionId": "text"
  },
  "createdAt": "2024-11-21T07:18:40.956Z"
}