Transactions

Platform transaction record. Aggregates the lifecycle of a financial operation, linking it to the underlying blockchain, banking, and market-order transactions.

Fields

Fields on the Transaction object.

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`status`	`TransactionStatus!`	Current processing status of the transaction.
`type`	`TransactionType!`	Category describing the origin of this transaction.
`blockchainTransaction`	`BlockchainTransaction`	Associated on-chain blockchain transaction, if any.
`userTransactions`	`UserTransactionConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Paginated list of user-level sub-transactions derived from this transaction.
`secondaryMarketOrderTransaction`	`SecondaryMarketOrderTransaction`	Secondary market trade that originated this transaction, if applicable.
`primaryMarketOrderTransaction`	`PrimaryMarketOrderTransaction`	Primary market settlement that originated this transaction, if applicable.
`bankingTransaction`	`BankingTransaction`	Banking transaction that originated this transaction, if applicable.

Queries

Root queries that return or operate on this object.

`transaction`

Retrieve a single transaction by its identifier.

type Query {
  transaction(id: ID!): Transaction!
}

Arguments

Argument	Type	Description
`id`	`ID!`	—

Returns

Transaction

`transactions`

Paginated list of transactions for a given user, optionally filtered by token.

type Query {
  transactions(first: Int, last: Int, before: String, after: String, userID: ID!, tokenID: ID): TransactionConnection!
}

Arguments

Argument	Type	Description
`first`	`Int`	—
`last`	`Int`	—
`before`	`String`	—
`after`	`String`	—
`userID`	`ID!`	—
`tokenID`	`ID`	—

Returns

TransactionConnection

`userTransaction`

Lookup a single user transaction by its ID.

type Query {
  userTransaction(id: ID!): UserTransaction
}

Arguments

Argument	Type	Description
`id`	`ID!`	—

Returns

UserTransaction

Related types

Supporting objects, inputs, and enums used by this page.

Objects

`BlockchainTransaction`

Type: object

On-chain blockchain transaction. Records the details and status of a transaction submitted to the Hyperledger Besu network.

Implements: Node

Fields

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`transactionHash`	`String!`	Hex-encoded hash uniquely identifying the transaction on-chain.
`status`	`BlockchainTransactionStatus!`	Current confirmation status of the blockchain transaction.
`type`	`BlockchainTransactionType!`	Category of on-chain operation performed.
`blockNumber`	`Int`	Block number in which the transaction was mined, if confirmed.
`minedAt`	`Time`	Timestamp when the block containing this transaction was mined.
`blockchainWalletAddressToken`	`String`	Wallet address holding the security token.
`blockchainWalletAddressEuroToken`	`String`	Wallet address holding the euro stablecoin token.
`blockchainWalletAddressFees`	`String`	Wallet address receiving platform fees.
`blockchainWalletAddressIssuer`	`String`	Wallet address of the token issuer.
`blockchainWalletAddressSubscriber`	`String`	Wallet address of the subscribing investor.
`volumeEuroToken`	`Uint64`	Euro-token amount transferred on-chain. Amount in euro cents.
`volumeToken`	`Uint64`	Number of tokens transferred on-chain.
`volumeEuroTakerFees`	`Uint64`	Taker fees collected on-chain. Amount in euro cents.
`volumeEuroMakerFees`	`Uint64`	Maker fees collected on-chain. Amount in euro cents.
`token`	`Token!`	Token involved in this blockchain transaction.

`TransactionConnection`

Type: object

Relay connection for paginated Transaction results.

Fields

Field	Type	Description
`nodes`	`[Transaction]!`	—
`edges`	`[TransactionEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`TransactionEdge`

Type: object

Relay edge wrapping a Transaction node with its pagination cursor.

Fields

Field	Type	Description
`cursor`	`String!`	—
`node`	`Transaction!`	—

`UserTransaction`

Type: object

Link between a user and a financial transaction, providing per-user transaction visibility.

Implements: Node

Fields

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`transaction`	`Transaction!`	Financial transaction associated with this record.
`user`	`User!`	User who owns or is party to the transaction.

`UserTransactionConnection`

Type: object

Relay connection for paginated UserTransaction results.

Fields

Field	Type	Description
`nodes`	`[UserTransaction]!`	—
`edges`	`[UserTransactionEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`UserTransactionEdge`

Type: object

Relay edge wrapping a UserTransaction node with its pagination cursor.

Fields

Field	Type	Description
`cursor`	`String!`	—
`node`	`UserTransaction!`	—

Enums

`BlockchainTransactionStatus`

Type: enum

Confirmation status of a blockchain transaction.

Values

Value	Description
`PENDING`	Transaction has been submitted but not yet mined.
`FAILED`	Transaction was mined but execution reverted.
`COMPLETED`	Transaction was mined and executed successfully.

`BlockchainTransactionType`

Type: enum

Category of on-chain operation performed by a blockchain transaction.

Values

Value	Description
`SETTLE`	Settlement of a primary or secondary market transaction.
`MINT`	Minting of new tokens into circulation.
`BURN`	Burning (destroying) tokens from circulation.
`SWAP`	Atomic swap of tokens for euro stablecoins.
`TRANSFER`	Transfer of tokens between wallets.

`TransactionStatus`

Type: enum

Processing status of a platform transaction.

Values

Value	Description
`PENDING`	Transaction is in progress and awaiting completion.
`COMPLETED`	Transaction settled successfully.
`FAILED`	Transaction failed to settle.

`TransactionType`

Type: enum

Category describing the origin of a platform transaction.

Values

Value	Description
`SECONDARY_MARKET_ORDER_TRANSACTION`	Originated from a secondary market trade.
`PRIMARY_MARKET_ORDER_TRANSACTION`	Originated from a primary market settlement.
`BANKING_TRANSACTION_CREDIT`	Credit (deposit) from the banking system.
`BANKING_TRANSACTION_DEBIT`	Debit (withdrawal) to the banking system.
`ADJUSTMENT`	Admin-initiated adjustment (mint, burn, or transfer) with no fees.
`ISSUER_LEGACY_SHAREHOLDER_TRANSACTION`	Originated from a legacy shareholder settlement (mint).