Transaction Manager via Endpoints
Maestro’s Transaction Manager is a state of the art tool that abstracts away the complexity of managing Cardano transaction states. It provides a transaction monitoring dashboard and webhook notification system to track all transactions submitted with Maestro's API.
This page will detail the Transaction Manager endpoints. Transaction manager endpoints allow one to get information about transactions, submit transactions to the network and obtaining updates on the status of transactions.
- Read more about Authorization and api-key usage here.
- The queries on this page are made to the Pre-Production test network.
- Endpoints that return lists of objects utilize cursor-based-pagination.
Submit transaction
POST /txmanager
This endpoint submits a signed and serialized transaction to the network.
All transactions submitted with this endpoint will be recorded and tracked by Maestro's Transaction Manager.
Learn how to monitor onchain transaction states in the Transaction Dashboard or get real-time notifications via Transaction Webhooks.
curl -X POST \
-H "api-key: <your_project_api_key>" \
-H "Content-Type: application/cbor" \
--data @tx.signed \
https://mainnet.gomaestro-api.org/v1/txmanager
Where, tx.signed
is a signed, CBOR-encoded binary representation of the transaction.
"bc14ee113224f818edc1dc87db034ca3a610dca03ecffa9603fb1b0de98677ac"
Reponse details
- The transaction hash of the submitted transaction.
- Response codes are documented here
Submit Turbo transaction
One Maestro's flagship products is Turbo Transactions, which supercharges transaction submission to the network.
The process of submitting a Turbo Transaction is identical to the guide above, except the endpoint should be /txmanager/turbosubmit
Follow our Submit a Turbo transaction page to see it in more detail.
Transaction state
GET /txmanager/{tx_hash}/state
This endpoint returns the most recent state of a transaction.
Parameters | Description | Example |
---|---|---|
tx_hash | Transaction hash | d6b882dad380aca9c607542704bdd57ac491d7b445d3a1d0d6d9046980639699 |
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/txmanager/d6b882dad380aca9c607542704bdd57ac491d7b445d3a1d0d6d9046980639699/state
{
"block": "1000437",
"state": "Onchain",
"timestamp": "2023-05-31T23:57:07.054466Z",
"transaction_hash": "c3c8e5aadb92dba337bc36ba45a38f0dea2cdad9186a880cd6d5e6f187323450"
}
Response details
- block: Block hash
- state: As detailed here
- timestamp: When originally submitted with Maestro
- transaction_hash: Transaction hash
Transactions history
POST /txmanager/history
This endpoint returns the history of submitted transactions.
curl -X 'GET' \
'https://mainnet.gomaestro-api.org/v1/txmanager/history' \
-H 'accept: application/json'
[
{
"block": "-",
"state": "Rejected",
"timestamp": "2023-06-01T02:42:59.902023Z",
"transaction_hash": "c3c8e5aadb92dba337bc36ba45a38f0dea2cdad9186a880cd6d5e6f187323450"
},
{
"block": "1000437",
"state": "Onchain",
"timestamp": "2023-05-31T23:57:07.054466Z",
"transaction_hash": "c3c8e5aadb92dba337bc36ba45a38f0dea2cdad9186a880cd6d5e6f187323450"
}
]
Response details
- block: Block hash
- state: As detailed here
- timestamp: When originally submitted with Maestro
- transaction_hash: Transaction hash