Transaction

Create and retrieve transactions.

GET /v1/:currency/Addresses/:address/Transactions

Get transaction history for a given address.

Request

Headers

Header
Type
Description
X-REQUEST-SIGNATURE
string
Address Signature of address path parameter. See X-REQUEST-SIGNATURE.

Path Parameters

Attribute
Type
Description
currency
string
The currency of the transactions.
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.
Currency
string
The currency of the transaction
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

Request

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
currency
string
The currency of the transaction.
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

Request

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.
Currency
string
The currency of the transaction.
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.
Idem
UUID
Optional. Used for idempotent requests. See Idempotent Requests.
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