Transactions

Push Transaction

post

/api/v1/transactions

Authorizations

Body

externalIdany of

External transaction ID

amountnumberrequired

Transfer amount

assetall ofrequired

Information about network and currency in which transaction was made

assetFormatany of

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

sourceAddressesstring[]required

Sender's wallet addresses

destinationAddressstring · min: 1required

Recipient's wallet address

txHashany of

Unique hash or identifier on the network

payloadobject

Transaction payload to help identify sender and recipient

feeany of

Network fee information

venueany of

Information about venue where transaction came from

createdAtstring · date-timerequired

Date and time of transaction

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.finchguard.com//api/v1/transactions' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "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-03-13T16:22:27.370Z"
  }'

200

400

401

403

422

200

{
  "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-03-13T16:22:27.370Z"
}

Successful Response