Skip to main content
POST
/
transactions
Create transactions in a wallet
curl --request POST \
  --url https://api.breezing.io/v1/transactions \
  --header 'Content-Type: application/json' \
  --data '
{
  "walletId": 1,
  "transactions": [
    {
      "direction": "in",
      "date": 1700000000,
      "transactionId": "0xabc123…",
      "token": "ETH",
      "amount": "1.5",
      "fee": "0.001",
      "feeToken": "<string>",
      "amountFiat": "3000.00",
      "feeFiat": "2.00",
      "type": "<string>",
      "chain": "<string>",
      "tokenAddress": "<string>",
      "feeTokenAddress": "<string>",
      "walletFrom": "<string>",
      "walletTo": "<string>",
      "account": "<string>",
      "assetAccount": "<string>",
      "feeAssetAccount": "<string>",
      "accountingDescription": "<string>",
      "note": "<string>",
      "extraLabel": "<string>",
      "vat": "<string>",
      "isSpam": true,
      "isNFT": true,
      "skipNgl": true,
      "skipNglReason": "<string>",
      "currency": "<string>",
      "functionName": "<string>",
      "tokenId": "<string>"
    }
  ],
  "doFiat": true
}
'
{
  "success": true,
  "data": {
    "created": 123,
    "walletId": 123,
    "taskId": 123,
    "transactionIds": [
      123
    ]
  }
}

Query Parameters

orgId
string
required

Organization ID. Use GET /v1/companies to discover available org/company pairs.

Example:

"1"

companyId
string
required

Company ID. Use GET /v1/companies to discover available companies and their access levels.

Example:

"1"

Body

application/json
walletId
integer
required

Wallet to add transactions to. Must belong to orgId/companyId. Any wallet type is allowed; transactions are tagged addedVia="publicApi".

Required range: x > 0
Example:

1

transactions
object[]
required

Transactions to insert (1 to 500). All inserted atomically. If any row fails validation, none are inserted.

Required array length: 1 - 500 elements
doFiat
boolean
default:true

When true (default), the process worker chain queues the fiat-pricing worker after processing (fills amountFiat/feeFiat). When false, balance calculation is queued directly without fiat backfill.

Response

Transactions inserted successfully

success
enum<boolean>
required
Available options:
true
data
object
required
Last modified on June 4, 2026