Skip to main content
POST
/
transactions
/
group-trades
Group transactions into trades
curl --request POST \
  --url https://api.breezing.io/v1/transactions/group-trades \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    123
  ]
}
'
{
  "success": true,
  "data": {
    "processed": 123,
    "dedupedFrom": 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
ids
integer[]
required

Transaction IDs to group into trades (max 500). The engine buckets them by timestamp and external reference, then forms a trade from each qualifying group. A group qualifies when the legs have opposite directions (one in, one out), different tokens, at most two wallets, and none is spam, already a trade (has an exchangeId), or internal. Non-qualifying transactions are left unchanged. Duplicate IDs are deduplicated server-side.

Required array length: 1 - 500 elements

Response

Transactions submitted to the grouping engine

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