Public Transactions API

You are here:
< Back

Create a transaction

Endpoint

POST /api/transactions

Body Parameters

NameTypeDescriptionRequired
transactionsarrayThe list of transactions to create.

Response

{
    "data": {
        "accept": [
            "15d4b3e933b79e5172bbf14c2bd3f92d927394cd8ebd102f18dcc2203af363ca",
            "c48862c4df75a8b0859b559658c757c1c289088488630494fe51613db0747e57",
            "bd10b25444363252e0787e46f5cac90797d08a0c34d507a10d064c94cccf6226",
            "ba9e1d4ad2db9f860deef0e5d5c46bbd9f16222295aafd468e23d4f3d04cfbb8",
            "27963debfa3ced1f606193e81fe3fae16c225c8607e0fd267266a448b5f38520",
            "e9fffd1536f43f36840b8fa2793d4ac473db97bd864bdd54910b4de19fd954db",
            "320111c0c0fd386907cd912e376690704ed118a559f86bd4e00e99db7b7ffc10",
            "176a6d425828f6e7120b790cd77f2a447e3e9b2ccf20808dcc97f027b6dd0eba",
            "dd7015b4bb3768e7ffc0c06a9b72f85f01abc69329e7990f864ebdc3daa1f9e3",
            "dad91ecf3e547cd6b7d7868d1c18b99b88f1f8d2c16ed5f1a7e96eb5a0010c0d"
        ],
        "excess": [],
        "invalid": []
    }
}

Retrieve a transaction

Endpoint

GET /api/transactions/{id}

Path Parameters

NameTypeDescriptionRequired
idstringThe identifier of the transaction to be retrieved.

Response

{
    "data": {
        "id": "5c6ce775447a5acd22050d72e2615392494953bb1fb6287e9ffb3c33eaeb79aa",
        "blockId": "4271682877946294396",
        "type": 0,
        "amount": 32106400000,
        "fee": 10000000,
        "sender": "DDiTHZ4RETZhGxcyAi1VruCXZKxBFqXMeh",
        "recipient": "DQnQNoJuNCvpjYhxL7fsnGepHBqrumgsyP",
        "signature": "3044022047c39f6f45a46a87f91ca867f9551dbebf0035adcfcbdc1370222c7a1517fc0002206fb5ecc10460e0352a8b626a508e2fcc76e39e490b0a2581dd772ebc8079696e",
        "confirmations": 1928,
        "timestamp": {
            "epoch": 32794053,
            "unix": 1522895253,
            "human": "2018-04-05T02:27:33Z"
        }
    }
}

List all transactions

Endpoint

GET /api/transactions

Query Parameters

NameTypeDescriptionRequired
pageintThe number of the page that will be returned.
limitintThe number of resources per page.
typeintThe transaction type to be retrieved.
blockIdintThe block id to be retrieved.
idintThe transaction id to be retrieved.

Response

{
    "meta": {
        "count": 2,
        "pageCount": 127430,
        "totalCount": 254860,
        "next": "/v2/transactions?page=2",
        "previous": null,
        "self": "/v2/transactions?page=1",
        "first": "/v2/transactions?page=1",
        "last": "/v2/transactions?page=127430"
    },
    "data": [
        {
            "id": "5c6ce775447a5acd22050d72e2615392494953bb1fb6287e9ffb3c33eaeb79aa",
            "blockId": "4271682877946294396",
            "version": 1,
            "type": 0,
            "amount": 32106400000,
            "fee": 10000000,
            "sender": "DDiTHZ4RETZhGxcyAi1VruCXZKxBFqXMeh",
            "recipient": "DQnQNoJuNCvpjYhxL7fsnGepHBqrumgsyP",
            "signature": "3044022047c39f6f45a46a87f91ca867f9551dbebf0035adcfcbdc1370222c7a1517fc0002206fb5ecc10460e0352a8b626a508e2fcc76e39e490b0a2581dd772ebc8079696e",
            "asset": {},
            "confirmations": 1924,
            "timestamp": {
                "epoch": 32794053,
                "unix": 1522895253,
                "human": "2018-04-05T02:27:33Z"
            }
        }
    ]
}

List all unconfirmed transaction

Endpoint

GET /api/transactions/unconfirmed/

Query Parameters

NameTypeDescriptionRequired
pageintThe number of the page that will be returned.
limitintThe number of resources per page.

Response

{
    "meta": {
        "count": 5, 
        "pageCount": 8, 
        "totalCount": 40, 
        "next": "/api/v2/transactions/unconfirmed?limit=5&page=2", 
        "previous": null, 
        "self": "/api/v2/transactions/unconfirmed?limit=5&page=1", 
        "first": "/api/v2/transactions/unconfirmed?limit=5&page=1", 
        "last": "/api/v2/transactions/unconfirmed?limit=5&page=8"
    }, 
        "data": [
            {
                "id": "c94504293d23e3be535a049fdfacba95147f2a87a4ef6682c56801da96befce0", 
                "version": 1, 
                "type": 0, 
                "amount": 70866123, 
                "fee": 344000, 
                "sender": "DMzBk3g7ThVQPYmpYDTHBHiqYuTtZ9WdM3", 
                "recipient": "DMzBk3g7ThVQPYmpYDTHBHiqYuTtZ9WdM3", 
                "signature": "30450221008adeff8eb2a780168704d9e210368d81edff79b81aa7b995e43486f3b1e0096502205caef345584319a6294b1f5283c0d17b478b8a9bcdc10570e5a58681b0eae332",       
                "vendorField": "Yooooooloooooo", 
                "confirmations": 0, 
                "timestamp": {
                    "epoch": 56388424, 
                    "unix": 1546489624, 
                    "human": "2019-01-03T04:27:04.000Z"
                 }
            }, 
            {
                 "id": "db2e54211c352217eee0313a01f6258ac1634e201f04f89b0561d34f7d598066", 
                 "version": 1, 
                 "type": 0,
                 "amount": 17130719, 
                 "fee": 344000, 
                 "sender": "DMzBk3g7ThVQPYmpYDTHBHiqYuTtZ9WdM3", 
                 "recipient": "DKahhVFVJfqCcCmaQHuYzAVFKcWjBu5i6Z", 
                 "signature": "30440220069f25d555157f3216b6725e1f66f37b126dcc039f2a4eb12fe74d9e93595d7b02202980215c9375d43f24ebd26a32d6db49f260ad55199c3a137b7dce61e324c970",          
                 "vendorField": "Yooooooloooooo", 
                 "confirmations": 0, 
                 "timestamp" : {
                     "epoch": 56388424, 
                     "unix": 1546489624, 
                     "human": "2019-01-03T04:27:04.000Z"
                 }
            }, 
            {
                "id": "825ab53b50fa99d339486ab780c6a187c7f4fbccfa1098f38be7f57226b144bd", 
                "version": 1, 
                "type": 0, 
                "amount": 11266113, 
                "fee": 344000, 
                "sender": "DMzBk3g7ThVQPYmpYDTHBHiqYuTtZ9WdM3", 
                "recipient": "DG92jj4vUW7SyxzM1VzkmQWMmgBGZVhrjb", 
                "signature": "3045022100918864cc6e5ae22010820f1d2a3d4677472d20d7a151597f3f6c705028f28dcf02203518b755fb860b40edfcde5107909d043e7a2cc38d66f5ca52710a0be7e6d710",       
                "vendorField": "Yooooooloooooo", 
                "confirmations": 0, 
                "timestamp": {
                    "epoch": 56388425, 
                    "unix": 1546489625, 
                    "human": "2019-01-03T04:27:05.000Z"
                 }
            }, 
            {
                 "id": "26146b25cde21ab72ecd49a0ac582372314625d854154cfd705dc841a4765ac8", 
                 "version": 1, 
                 "type": 0, 
                 "amount": 737042, 
                 "fee": 344000, 
                 "sender": "DMzBk3g7ThVQPYmpYDTHBHiqYuTtZ9WdM3", 
                 "recipient": "DN8nGwcNbE3YcnZYFp8uvvc9z4WWDbytWK", 
                 "signature": "3044022067abb680cd6699cf5dac9194c576949dce4b29fe3e4d108724829e8aa34d8a3c02205a3bb91bb46a0182c1dc393c05538e0b673702c75ff39ad0acbf6b879082d911",          
                 "vendorField": "Yooooooloooooo", 
                 "confirmations": 0, 
                 "timestamp": {
                     "epoch": 56388425, 
                     "unix": 1546489625, 
                     "human": "2019-01-03T04:27:05.000Z"
                 }
            }, 
            {
                 "id": "7f54d415750361b3f15bdd4c85d73cbc6ea43efbee6e7725048c223cadd9a4b2", 
                 "version": 1, 
                 "type": 0, 
                 "amount": 70866123, 
                 "fee": 344000, 
                 "sender": "DMzBk3g7ThVQPYmpYDTHBHiqYuTtZ9WdM3", 
                 "recipient": "DMzBk3g7ThVQPYmpYDTHBHiqYuTtZ9WdM3", 
                 "signature": "304402207a2f0ce904148dfa1aa0ffc685bdf0614b2e98de98f32b108dd205174d6b767102201566d703296801057e8f94c396fc5be208e6bddde20f5d70be3f46fbcf640bbd",          
                 "vendorField": "Yooooooloooooo", 
                 "confirmations": 0, 
                 "timestamp": {
                     "epoch": 56388425, 
                     "unix": 1546489625, 
                     "human": "2019-01-03T04:27:05.000Z"
                  }
            }
     ]
}

Get an unconfirmed transaction

Endpoint

GET /api/transactions/unconfirmed/{id}

Path Parameters

NameTypeDescriptionRequired
idstringThe identifier of the transaction to be retrieved.

Response

{
     "data": {
          "id": "c94504293d23e3be535a049fdfacba95147f2a87a4ef6682c56801da96befce0", 
          "version": 1, 
          "type": 0, 
          "amount": 70866123, 
          "fee": 344000, 
          "sender": "DMzBk3g7ThVQPYmpYDTHBHiqYuTtZ9WdM3", 
          "recipient": "DMzBk3g7ThVQPYmpYDTHBHiqYuTtZ9WdM3", 
          "signature": "30450221008adeff8eb2a780168704d9e210368d81edff79b81aa7b995e43486f3b1e0096502205caef345584319a6294b1f5283c0d17b478b8a9bcdc10570e5a58681b0eae332", 
          "vendorField": "Yooooooloooooo", 
          "confirmations": 0, 
          "timestamp": {
               "epoch": 56388424, 
               "unix": 1546489624, 
               "human": "2019-01-03T04:27:04.000Z"
          }
     }
}

Search for transactions

Endpoint

POST /api/transactions/search

Query Parameters

NameTypeDescriptionRequired
pageintThe number of the page that will be returned.
limitintThe number of resources per page.

Body Parameters

NameTypeDescriptionRequired
orderBystring
idstring
blockIdstring
typeint
versionint
senderPublicKeystring
senderIdstring
recipientIdstring
ownerIdstring
vendorFieldHexstring
timestampobject
timestamp.fromint
timestamp.toint
amountobject
amount.fromint
amount.toint
feeobject
fee.fromint
fee.toint

Response

{
     "meta": {
          "Count": 1, 
          "PageCount": 79382, 
          "totalCount": 79382, 
          "next": "/api/v2/transactions/search?limit=1&page=2", 
          "previous": null, 
          "self": "/api/v2/transactions/search?limit=1&page=1", 
          "first": "/api/v2/transactions/search?limit=1&page=1", 
          "last": "/api/v2/transactions/search?limit=1&page=79382"
     }, 
     "data" : [
          {
               "id": "026fbc15cf630e8fc2a3e963d2c436c744d880611a468b34b85145e181b80dc0", 
               "blockId": "14085724014999449555", 
               "version": 1, 
               "type": 0, 
               "amount": 737042, 
               "fee": 344000, 
               "sender": "DMzBk3g7ThVQPYmpYDTHBHiqYuTtZ9WdM3", 
               "recipient": "DN8nGwcNbE3YcnZYFp8uvvc9z4WWDbytWK", 
               "signature": "3045022100cb2c2d9086188f4b09c97b99374da91579d15c99206bbb04512053922cb0209f022026a4676483d1162eaafd64d2acfa43413e02f587922cf55f3205bbf509bd118b", 
               "vendorField": "Yooooooloooooo", 
               "confirmations": 103, 
               "timestamp": {
                    "epoch": 56388434, 
                    "unix": 1546489634, 
                    "human": "2019-01-03T04:27:14.000Z"
               }
          }
     ]
}

Get transaction types

Endpoint

GET /api/transactions/types

Response

{
     "data": {
          "Transfer": 0, 
          "SecondSignature": 1, 
          "DelegateRegistration": 2, 
          "Vote": 3, 
          "MultiSignature": 4, 
          "Ipfs": 5, 
          "TimelockTransfer": 6, 
          "MultiPayment": 7, 
          "DelegateResignation": 8
     }
}

Get transaction fees (non-dynamic)

Endpoint

GET /api/transactions/fees

Response

{
     "data": {
          "transfer": 10000000, 
          "secondSignature": 500000000, 
          "delegateRegistration": 2500000000, 
          "vote": 100000000, 
          "multiSignature": 500000000, 
          "ipfs": 0, 
          "timelockTransfer": 0, 
          "multiPayment": 0, 
          "delegateResignatio": 0
     }
}
Last Updated On January 14, 2019