Create BTC Transaction

Creates a Bitcoin transaction and returns it to the client for signing and sends it to the registered devices for signing (if applicable). The amount is always sent in Satoshis (100,000,000 Satoshi = 1BTC).

Transaction speed will determine how much fee is paid to the miners. All items created will need to be confirmed by the user in the inbox or can be signed by the API using the Add Signature Mutation.

The sendToDevicesForSigning must be set to true to allow the bitcoin transaction to be signed via the Add Signature Mutation (It will also trigger registered devices to be notified of the transaction). Setting this value to true will return a requestId which can be passed to the Add Signature Mutation.

Setting sendToDevicesForSigning = false is effectively a "dry-run" option allowing the caller to see the Bitcoin transaction but not process it. Add Signature is not possible if this flag has been set to false.

NB: Repeatedly calling createTransaction may result in different transactions for signing if the wallet has received or spent funds in ther interim.

Pass the SubWalletId which is available in the getWallets query

curl --location --request POST 'https://tapi-sandbox.trustology-test.com/graphql/' \ --header 'x-api-key: {{tapi-key}}' \ --header 'Content-Type: application/json' \ --data-raw '{"query":"mutation(\n\t$to: String!\n\t$subWalletId: String!\n\t$value: String!\n) {\n\tcreateBitcoinTransaction(\n\t\tcreateBitcoinTransactionInput: {\n\t\t\tbitcoinTransactionParams: {\n\t\t\t\tsubWalletId: $subWalletId\n\t\t\t\tto: $to\n\t\t\t\tamount: { value: $value, currency: \"SATOSHI\" }\n\t\t\t\tsatoshiPerByte: \"1\"\n\t\t\t}\n\t\t\tsource: \"API\"\n\t\t\tsendToNetworkWhenSigned: true\n\t\t\tsendToDevicesForSigning: true\n\t\t}\n\t){\n\t\tfee\n\t\tmaxAllowedToSend\n\t\tfeeForMax\n\t\tchainRate\n\t\tbalance\n\t\tsignData {\n\t\t\ttransaction {\n\t\t\t\tversion\n\t\t\t\tinputs {\n\t\t\t\t\taddress\n\t\t\t\t\ttxId\n\t\t\t\t\toutputIndex\n\t\t\t\t\tscript\n\t\t\t\t\tsequence\n\t\t\t\t\tvalue\n\t\t\t\t\tunverifiedDigestData{\n\t\t\t\t\t\ttransactionDigest\n\t\t\t\t\t\tshaSignData\n\t\t\t\t\t\tsignData\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\toutputs {\n\t\t\t\t\trecipientAddress\n\t\t\t\t\tamountToSend\n\t\t\t\t}\n\t\t\t\tlockTime\n\t\t\t\tsighash\n\t\t\t}\n\t\t\tchangeAddressProvenance {\n\t\t\t\tpublicKey\n\t\t\t\tpath\n\t\t\t\tunverifiedAddress\n\t\t\t\taddressType\n\t\t\t}\n\t\t}\n\t\t... on CreateBitcoinTransactionIdResponse {\n\t\t\trequestId\n\t\t}\n\t}\n}\n","variables":{"subWalletId":"902223ec-e7df-4509-9af0-59a4e46a90ea/BTC/0","to":"2NCtC2FZvUpkyG6k46eHXJGkLUTShetnkis","value":"1000"}}'

Request

Responses