Transaction
Create and retrieve transactions.
GET /v1/:currency/Addresses/:address/Transactions
GET /v1/:currency/Addresses/:address/TransactionsGet transaction history for a given address.
Request
Headers
Header
Type
Description
Path Parameters
Attribute
Type
Description
address
string
The public address associated with the transactions.
Query Parameters
Attribute
Type
Description
status
string
Optional. Either Confirmed or Incomplete.
Confirmed (default) - Only includes confirmed transactions on the blockchain.
Incomplete - Only includes unconfirmed and failed transactions in Gluwa.
offset
int
Optional. The number of entries to skip.
limit
int
Optional. The number of transactions returned in in the response (max 100).
Response
HTTP Status
Return Object
200
array of Transaction.
Transaction
Attribute
Type
Description
Status
string
The status of the transaction.Unconfirmed, Confirmed, or Failed.
Unconfirmed - The transaction was announce to the blockchain, but is not included in any block yet. Confirmed - The transaction was included in the blockchain and received a confirmation. Failed - The transaction has failed for some reason.
Amount
string
The amount sent or received in this transaction.
TotalAmount
string
The sum of the Amount and the Fee.
Sources
array of string
The sources of the transaction. For BTC, there can be multiple sources.
Targets
array of string
The targets of the transaction. For BTC, there can be multiple targets.
TxnHash
string
Blockchain transaction hash.
CreatedDateTime
datetime
Time at which the transaction was created.
ModifiedDateTime
datetime
Time at which the transaction was last modified.
MerchantOrderID
string
Optional. Used by the receiver to identify a payment. Supported by QR code payment feature only.
Note
string
Optional. A message attached to the transaction. It is an optional memo you can associate with the transaction.
Fee
string
Optional. Transaction fee.
ID
UUID
Optional. Gluwa's internal transaction ID. If the transaction was made outside of Gluwa's system (ex> Transaction was made directly on the blockchain), then this will not be available.
Errors
HTTP Status
Error Code
Description
400
InvalidUrlParameters
Invalid URL parameters
400
BadRequest
Invalid address format.
403
SignatureMissing
X-REQUEST-SIGNATURE header is missing.
403
SignatureExpired
X-REQUEST-SIGNATURE has expired.
403
InvalidSignature
Invalid X-REQUEST-SIGNATURE.
500
InternalServerError
Server error.
503
ServiceUnavailable
Service unavailable for the specified currency
GET /v1/:currency/Transactions/:txnhash
GET /v1/:currency/Transactions/:txnhashRequest
Headers
Header
Type
Description
X-REQUEST-SIGNATURE
string
Address Signature of an address involved with txnhash. See X-REQUEST-SIGNATURE.
Path Parameters
Attribute
Type
Description
txnhash
string
Blockchain transaction hash.
Response
HTTP Status
Return Object
200
Errors
HTTP Status
Error Code
Description
400
InvalidUrlParameters
Invalid URL parameters
400
BadRequest
Invalid txnhash value.
403
SignatureMissing
X-REQUEST-SIGNATURE header is missing.
403
SignatureExpired
X-REQUEST-SIGNATURE has expired.
403
InvalidSignature
Invalid X-REQUEST-SIGNATURE.
404
NotFound
Transaction not found.
500
InternalServerError
Server error.
503
ServiceUnavailable
Service unavailable for the specified currency
POST /v1/Transactions
POST /v1/TransactionsRequest
Request Body
Attribute
Type
Description
Signature
string
Transaction signed with the sender's private key. See Creating Transaction Signatures.
Amount
string
Transaction amount, not including the fee. This is the amount that the receiver receives.
Fee
string
Transaction fee amount. Generally, you should use the amount from the Fee endpoint. Your transaction may not get processed by Gluwa if the fee amount is smaller than the minimum fee amount.
Source
string
Address of the sender.
Target
string
Address of the receiver.
Nonce
string
Optional. Required if using Gluwacoin as the currency of the transaction. Nonce is an unsigned integer used when creating reserve transaction signature. It must be unique each time you make any new transactions (transfer, exchange, etc). Maximum value is 2^256-1.
MerchantOrderID
string
Optional. A string value attached to the transaction which can be used for traceability between Gluwa and your application.
Note
string
Optional. Optional memo attached to the transaction.
PaymentID
UUID
Optional. A unique identifier for a payment used with QR code payment feature. You can get this value by decoding the QR code.
PaymentSig
string
Optional. Required if PaymentID is not null. This is provided to you when you use QR Code endpoint. You can get this value by decoding the QR code.
Response
HTTP Status
Return Object
202
Optional. TransactionHash. Only for BTC transactions.
TransactionHash
Attribute
Type
Description
TxnHash
string
BTC transaction hash. For Gluwacoin transactions, the transaction hash is not immediately available, so it is not included in the response.
Errors
HTTP Status
Error Code
Description
400
InvalidUrlParameters
Invalid URL parameters
400
MissingBody
Request body is missing.
400
InvalidBody
Request validation errors.
400
ValidationError
Request validation errors.
403
InvalidPaymentSignature
Invalid payment signature.
409
Conflict
Transfer already exists.
500
InternalServerError
Server error.
503
ServiceUnavailable
Service unavailable for the specified currency
Last updated