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	Transaction.

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