Coinbax Core API

Transactions

Global transaction management

List transactions

GET/transactionsBearer token

Retrieve a paginated list of transactions. Transactions are aggregated from all connected platforms (via platform mappings) or from the global API key. **Filtering:** - Filter by status, date range, addresses, wallet address **Pagination:** - Default: 20 items per page - Max: 100 items per page

Query parameters

pageinteger
Page number (1-indexed)
limitinteger
Items per page
statusenum
Filter by transaction status
"PENDING" · "ESCROWED" · "IN_REVIEW" · "COMPLETED" · "FAILED" · "CANCELLED"
dateFromstring (date-time)
Start date filter (ISO 8601)
dateTostring (date-time)
End date filter (ISO 8601)
fromAddressstring
Filter by sender wallet address
toAddressstring
Filter by receiver wallet address
walletAddressstring
Filter by either sender or receiver address

Responses

200Transaction list retrieved successfully

SuccessResponse
- successenumrequiredtrue
  Always true for successful responses
- dataobjectrequired
  Response data (structure varies by endpoint)
- metaMetarequired
  timestampstring (date-time)required
  Response timestamp
  requestIdstringrequired
  Unique request identifier for debugging
  paginationPagination
  pageintegerrequired
  Current page number (1-indexed)
  limitintegerrequired
  Items per page
  totalintegerrequired
  Total number of items
  totalPagesintegerrequired
  Total number of pages
object
- dataobject
  dataarray of Transaction
  array of Transaction
  idstring (uuid)required
  Transaction unique identifier
  statusenumrequired"PENDING" · "ESCROWED" · "IN_REVIEW" · "COMPLETED" · "FAILED" · "CANCELLED"
  Transaction status
  amountstringrequired
  Transaction amount as string
  currencystringrequired
  Transaction currency
  fromAddressstring
  Sender's blockchain address
  toAddressstring
  Receiver's blockchain address
  blockchainNetworkstring
  Blockchain network
  chainIdinteger
  Chain ID
  txHashstring
  Blockchain transaction hash
  orchestrationTypeenum"raw" · "coinbax"
  Transaction orchestration type
  metadataobject
  Transaction metadata
  object
  Transaction metadata
  createdAtstring (date-time)required
  Transaction creation timestamp
  updatedAtstring (date-time)
  Last update timestamp
  _platformNamestring
  Platform name (for multi-platform queries)
  _platformIdstring
  Platform ID (for multi-platform queries)
  metaobject
  totalinteger
  pageinteger
  limitinteger
  totalPagesinteger
  platformCountinteger
  Number of platforms queried

{
  "success": true,
  "data": {
    "data": [
      {
        "id": "tx_abc123",
        "status": "COMPLETED",
        "amount": "100.00",
        "currency": "USDC",
        "fromAddress": "0x1234567890abcdef1234567890abcdef12345678",
        "toAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
        "blockchainNetwork": "base",
        "chainId": 8453,
        "txHash": "0xabcd...ef12",
        "createdAt": "2026-02-24T10:00:00.000Z",
        "_platformName": "Main Platform",
        "_platformId": "platform_xyz"
      }
    ],
    "meta": {
      "total": 150,
      "page": 1,
      "limit": 20,
      "totalPages": 8,
      "platformCount": 3
    }
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

401Unauthorized - missing or invalid authentication

successenumrequiredfalse
Always false for error responses
dataobject
Always null for error responses
object
Always null for error responses
errorErrorrequired
- codestringrequired
  Machine-readable error code
- messagestringrequired
  Human-readable error message
- statusCodeintegerrequired
  HTTP status code
- detailsobject
  Additional error details (optional)
  object
  Additional error details (optional)
metaMetarequired
- timestampstring (date-time)required
  Response timestamp
- requestIdstringrequired
  Unique request identifier for debugging
- paginationPagination
  pageintegerrequired
  Current page number (1-indexed)
  limitintegerrequired
  Items per page
  totalintegerrequired
  Total number of items
  totalPagesintegerrequired
  Total number of pages

{
  "success": false,
  "data": null,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required",
    "statusCode": 401
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

500Internal server error

successenumrequiredfalse
Always false for error responses
dataobject
Always null for error responses
object
Always null for error responses
errorErrorrequired
- codestringrequired
  Machine-readable error code
- messagestringrequired
  Human-readable error message
- statusCodeintegerrequired
  HTTP status code
- detailsobject
  Additional error details (optional)
  object
  Additional error details (optional)
metaMetarequired
- timestampstring (date-time)required
  Response timestamp
- requestIdstringrequired
  Unique request identifier for debugging
- paginationPagination
  pageintegerrequired
  Current page number (1-indexed)
  limitintegerrequired
  Items per page
  totalintegerrequired
  Total number of items
  totalPagesintegerrequired
  Total number of pages

{
  "success": false,
  "data": null,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "An unexpected error occurred",
    "statusCode": 500
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

curlNode.js

curl https://core-staging.coinbax.com/api/v1/transactions \
  -H "Authorization: Bearer $ACCESS_TOKEN"

const response = await fetch('https://core-staging.coinbax.com/api/v1/transactions', {
  headers: {
    'Authorization': `Bearer ${process.env.ACCESS_TOKEN}`,
  },
});
const result = await response.json();

Get transaction by ID

GET/transactions/{id}Bearer token

Retrieve a transaction by its unique identifier. The transaction is searched across all connected platforms.

Path parameters

idstring (uuid)required
Transaction UUID

Responses

200Transaction found

SuccessResponse
- successenumrequiredtrue
  Always true for successful responses
- dataobjectrequired
  Response data (structure varies by endpoint)
- metaMetarequired
  timestampstring (date-time)required
  Response timestamp
  requestIdstringrequired
  Unique request identifier for debugging
  paginationPagination
  pageintegerrequired
  Current page number (1-indexed)
  limitintegerrequired
  Items per page
  totalintegerrequired
  Total number of items
  totalPagesintegerrequired
  Total number of pages
object
- dataTransaction
  idstring (uuid)required
  Transaction unique identifier
  statusenumrequired"PENDING" · "ESCROWED" · "IN_REVIEW" · "COMPLETED" · "FAILED" · "CANCELLED"
  Transaction status
  amountstringrequired
  Transaction amount as string
  currencystringrequired
  Transaction currency
  fromAddressstring
  Sender's blockchain address
  toAddressstring
  Receiver's blockchain address
  blockchainNetworkstring
  Blockchain network
  chainIdinteger
  Chain ID
  txHashstring
  Blockchain transaction hash
  orchestrationTypeenum"raw" · "coinbax"
  Transaction orchestration type
  metadataobject
  Transaction metadata
  object
  Transaction metadata
  createdAtstring (date-time)required
  Transaction creation timestamp
  updatedAtstring (date-time)
  Last update timestamp
  _platformNamestring
  Platform name (for multi-platform queries)
  _platformIdstring
  Platform ID (for multi-platform queries)

{
  "success": true,
  "data": {
    "id": "tx_550e8400-e29b-41d4-a716-446655440000",
    "status": "COMPLETED",
    "amount": "100.00",
    "currency": "USDC",
    "fromAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "toAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "blockchainNetwork": "base",
    "chainId": 8453,
    "txHash": "0xabcdef1234567890abcdef1234567890abcdef12345678901234567890abcdef12",
    "orchestrationType": "raw",
    "metadata": {
      "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
    },
    "createdAt": "2026-02-24T10:00:00.000Z",
    "updatedAt": "2026-02-24T10:05:00.000Z",
    "_platformName": "Main Platform",
    "_platformId": "platform_xyz"
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

401Unauthorized - missing or invalid authentication

successenumrequiredfalse
Always false for error responses
dataobject
Always null for error responses
object
Always null for error responses
errorErrorrequired
- codestringrequired
  Machine-readable error code
- messagestringrequired
  Human-readable error message
- statusCodeintegerrequired
  HTTP status code
- detailsobject
  Additional error details (optional)
  object
  Additional error details (optional)
metaMetarequired
- timestampstring (date-time)required
  Response timestamp
- requestIdstringrequired
  Unique request identifier for debugging
- paginationPagination
  pageintegerrequired
  Current page number (1-indexed)
  limitintegerrequired
  Items per page
  totalintegerrequired
  Total number of items
  totalPagesintegerrequired
  Total number of pages

{
  "success": false,
  "data": null,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required",
    "statusCode": 401
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

404Resource not found

successenumrequiredfalse
Always false for error responses
dataobject
Always null for error responses
object
Always null for error responses
errorErrorrequired
- codestringrequired
  Machine-readable error code
- messagestringrequired
  Human-readable error message
- statusCodeintegerrequired
  HTTP status code
- detailsobject
  Additional error details (optional)
  object
  Additional error details (optional)
metaMetarequired
- timestampstring (date-time)required
  Response timestamp
- requestIdstringrequired
  Unique request identifier for debugging
- paginationPagination
  pageintegerrequired
  Current page number (1-indexed)
  limitintegerrequired
  Items per page
  totalintegerrequired
  Total number of items
  totalPagesintegerrequired
  Total number of pages

{
  "success": false,
  "data": null,
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found",
    "statusCode": 404
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

500Internal server error

successenumrequiredfalse
Always false for error responses
dataobject
Always null for error responses
object
Always null for error responses
errorErrorrequired
- codestringrequired
  Machine-readable error code
- messagestringrequired
  Human-readable error message
- statusCodeintegerrequired
  HTTP status code
- detailsobject
  Additional error details (optional)
  object
  Additional error details (optional)
metaMetarequired
- timestampstring (date-time)required
  Response timestamp
- requestIdstringrequired
  Unique request identifier for debugging
- paginationPagination
  pageintegerrequired
  Current page number (1-indexed)
  limitintegerrequired
  Items per page
  totalintegerrequired
  Total number of items
  totalPagesintegerrequired
  Total number of pages

{
  "success": false,
  "data": null,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "An unexpected error occurred",
    "statusCode": 500
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

curlNode.js

curl https://core-staging.coinbax.com/api/v1/transactions/<id> \
  -H "Authorization: Bearer $ACCESS_TOKEN"

const response = await fetch('https://core-staging.coinbax.com/api/v1/transactions/<id>', {
  headers: {
    'Authorization': `Bearer ${process.env.ACCESS_TOKEN}`,
  },
});
const result = await response.json();

Get transaction statistics

GET/transactions/statsBearer token

Retrieve aggregated transaction statistics across all connected platforms. Returns counts and totals grouped by transaction status.

Responses

200Transaction statistics retrieved successfully

SuccessResponse
- successenumrequiredtrue
  Always true for successful responses
- dataobjectrequired
  Response data (structure varies by endpoint)
- metaMetarequired
  timestampstring (date-time)required
  Response timestamp
  requestIdstringrequired
  Unique request identifier for debugging
  paginationPagination
  pageintegerrequired
  Current page number (1-indexed)
  limitintegerrequired
  Items per page
  totalintegerrequired
  Total number of items
  totalPagesintegerrequired
  Total number of pages
object
- dataTransactionStats
  object

{
  "success": true,
  "data": {
    "COMPLETED": {
      "count": 1500,
      "total_amount": "150000.00"
    },
    "PENDING": {
      "count": 25,
      "total_amount": "2500.00"
    },
    "ESCROWED": {
      "count": 10,
      "total_amount": "1000.00"
    },
    "IN_REVIEW": {
      "count": 5,
      "total_amount": "500.00"
    },
    "FAILED": {
      "count": 15,
      "total_amount": "1500.00"
    },
    "CANCELLED": {
      "count": 8,
      "total_amount": "800.00"
    }
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

401Unauthorized - missing or invalid authentication

successenumrequiredfalse
Always false for error responses
dataobject
Always null for error responses
object
Always null for error responses
errorErrorrequired
- codestringrequired
  Machine-readable error code
- messagestringrequired
  Human-readable error message
- statusCodeintegerrequired
  HTTP status code
- detailsobject
  Additional error details (optional)
  object
  Additional error details (optional)
metaMetarequired
- timestampstring (date-time)required
  Response timestamp
- requestIdstringrequired
  Unique request identifier for debugging
- paginationPagination
  pageintegerrequired
  Current page number (1-indexed)
  limitintegerrequired
  Items per page
  totalintegerrequired
  Total number of items
  totalPagesintegerrequired
  Total number of pages

{
  "success": false,
  "data": null,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required",
    "statusCode": 401
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

500Internal server error

successenumrequiredfalse
Always false for error responses
dataobject
Always null for error responses
object
Always null for error responses
errorErrorrequired
- codestringrequired
  Machine-readable error code
- messagestringrequired
  Human-readable error message
- statusCodeintegerrequired
  HTTP status code
- detailsobject
  Additional error details (optional)
  object
  Additional error details (optional)
metaMetarequired
- timestampstring (date-time)required
  Response timestamp
- requestIdstringrequired
  Unique request identifier for debugging
- paginationPagination
  pageintegerrequired
  Current page number (1-indexed)
  limitintegerrequired
  Items per page
  totalintegerrequired
  Total number of items
  totalPagesintegerrequired
  Total number of pages

{
  "success": false,
  "data": null,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "An unexpected error occurred",
    "statusCode": 500
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

curlNode.js

curl https://core-staging.coinbax.com/api/v1/transactions/stats \
  -H "Authorization: Bearer $ACCESS_TOKEN"

const response = await fetch('https://core-staging.coinbax.com/api/v1/transactions/stats', {
  headers: {
    'Authorization': `Bearer ${process.env.ACCESS_TOKEN}`,
  },
});
const result = await response.json();