Skip to Content
DevelopmentHistorical Transactions

Historical Transactions

GET /historical-transactions/issuer-id/:issuerId returns every stock issuance, transfer, cancellation, and other equity event recorded for a cap table.

When rows appear

History comes from the event poller, not from the route or wallet that sent the transaction, so a confirmed transaction shows up after the poller’s next pass, usually within about 20 seconds. pnpm prod-poller reads only finalized blocks, which adds about 20 minutes on Plume.

Read the history

curl -s "$API/historical-transactions/issuer-id/$ISSUER_ID"

The response is an array of rows:

FieldMeaning
_idThe history row’s id.
transactionTypeOne of the types below.
transactionThe full transaction document, populated from its own collection.
issuerThe issuer id.
tx_hashHash of the onchain transaction, for explorer links. Older rows may have null.
createdAt, updatedAtWhen the row was written to MongoDB.
Response
[ { "_id": "6719d3c1f1a2b3c4d5e6f701", "transactionType": "StockIssuance", "issuer": "<ISSUER_ID>", "tx_hash": "0x4f8a2c1e9b7d6a5f3e2d1c0b9a8f7e6d5c4b3a2918f7e6d5c4b3a2918f7e6d5c", "transaction": { "_id": "56d14df5-6b04-7d93-1976-5e3f0d1703de", "object_type": "TX_STOCK_ISSUANCE", "security_id": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d", "stakeholder_id": "<STAKEHOLDER_ID>", "stock_class_id": "<STOCK_CLASS_ID>", "quantity": "100000", "share_price": { "amount": "4.2", "currency": "USD" }, "custom_id": "CS-001", "date": "2026-01-01", "issuer": "<ISSUER_ID>", "is_onchain_synced": true }, "createdAt": "2026-01-01T18:40:12.345Z", "updatedAt": "2026-01-01T18:40:12.345Z" } ]

The poller converts quantities and prices back to human values, so "4.2" is 4.20 per share. Adjustment rows store new_shares_authorized the same way, with issuer_id on issuer rows and stock_class_id on class rows (null when the adjustment was sent through another contract, such as a multisig). Rows written by older server versions hold the raw ×1e10 value, an empty issuer_id, and no stock_class_id until a poller reindex rewrites them.

Transaction types

transactionTypeWritten for
StockIssuanceissueStock, plus every new security created by a transfer or by a partial cancel or repurchase
StockTransfertransferStock, one row per security the transfer uses
StockCancellationcancelStock
StockRetractionretractStockIssuance
StockReissuancereissueStock
StockRepurchaserepurchaseStock
StockAcceptanceacceptStock
IssuerAuthorizedSharesAdjustmentadjustIssuerAuthorizedShares
StockClassAuthorizedSharesAdjustmentadjustStockClassAuthorizedShares

Creating a stakeholder or stock class adds no history row. The poller only marks the record is_onchain_synced.

Sorting and pagination

Rows come back unsorted, with no pagination. StockTransfer documents have no date, so sort by createdAt, which follows the order the poller processed the events.

What’s next?

Last updated on