BLOCKCHAIN_TRANSFER

On chain transaction to a specified wallet.

Status Transitions

Event

Status

Description

Settlement Created

WAITING_USER

Waiting for on chain transactions to be broadcast. Settlement will skip the READY state and immediately begin monitoring mempool for related transactions.

Transaction seen in mempool

WAITING_EXTERNAL

Transactions observed in mempool with sufficient network fee. Gross value of transactions must sum to expected funding quantity.

Transactions confirmed.

COMPLETE

Transactions have been confirmed a sufficient number of times.

Settlement timed out

CANCELLED

Settlement automatically cancelled as no mempool transaction observed within two hours.

Excess quantity received

MANUAL_INTERVENTION_REQUIRED

Gross value of transactions exceed expected funding quantity and allow_at_best_recovery is set to false. Settlement must be manually recovered by Liquid support.

Parameters

Setup Parameters

Field

Type

Description

Always Present

account_key

WALLET_ADDRESS

Customer wallet address

true

transaction_key

MEMO_ID

Memo/comment

false

Input Parameters

None

Result Parameters

Field

Type

Description

Always Present

transaction_key

TRANSACTION_HASH

Transaction Hash

true

Example Status Response

GET https://partners.liquid.com/api/v1/transaction/status/3be28d7a-dc2a-4318-b9e8-3d21c1a1d221
{
  "success": true,
  "environment": "PRODUCTION",
  "message": "Transaction created. Transaction is filled. Payout has been delivered.",
  "payload": {
    "transaction_id": "3be28d7a-dc2a-4318-b9e8-3d21c1a1d221",
    "api_key": "ef6cf2a7-a6e8-48d1-8c8a-677187dfcd8f",
    "status": "FILLED",
    "funding_settlement": {
      "settlement_instruction_id": "c5937977-d8f2-460a-86a1-3bb24e53e1dc",
      "transaction_id": "3be28d7a-dc2a-4318-b9e8-3d21c1a1d221",
      "currency": "DASH",
      "direction": "FUNDING",
      "method": "BLOCKCHAIN_TRANSFER",
      "quantity": "0.0010",
      "status": "COMPLETE",
      "expires": {
        "unix_ms": 1589273179767,
        "iso8601": "2020-05-12T08:46:19.767Z",
        "ttl_ms": 20000
      },
      "setup_parameters": {
        "wallet_address": "Xq33CwAcmgMZqBcENK7sVLFvfpv8yY6cjj"        
      },
      "result_parameters": {
        "wallet_address": "Xq33CwAcmgMZqBcENK7sVLFvfpv8yY6cjj",
        "transaction_hash": "7fee4ecf4c55a7924993dad7123f439867e8394754ec791c279cf0807af66ff9"
      },
      "_links": {
        "status": {
          "href": "https://partners.liquid.com/api/v1/settlement/status/c5937977-d8f2-460a-86a1-3bb24e53e1dc"
        },
        "bip21": {
          "href": "dash:Xq33CwAcmgMZqBcENK7sVLFvfpv8yY6cjj?amount=0.0010"
        },
        "bip21_qr_img": {
          "href": "https://partners.liquid.com/api/v1/method/qr/c5937977-d8f2-460a-86a1-3bb24e53e1dc"
        }
      }
    },
    "payout_settlement": {
      "settlement_instruction_id": "e875f3dd-d451-45df-a11f-9d1a31cd0353",
      "transaction_id": "3be28d7a-dc2a-4318-b9e8-3d21c1a1d221",
      "currency": "BCH",
      "direction": "PAYOUT",
      "method": "BLOCKCHAIN_TRANSFER",
      "quantity": "0.0002840",
      "status": "COMPLETE",
      "expires": {
        "unix_ms": 1589273169343,
        "iso8601": "2020-05-12T08:46:09.343Z",
        "ttl_ms": 20000
      },
      "input_parameters": {
        "wallet_address": "qqunjlfcuq0kz26e0223kl08nhdt2eldev4jdvyak6"
      },
      "result_parameters": {
        "wallet_address": "16DaPMKt6vHmTB3qpdLPf9CFBBhBZG2Gou",
        "transaction_hash": "73bb2bc17cb8278fbb7373687a4c56e46c3dd8b8517dee4dee394ef186955c6e"
      },
      "_links": {
        "status": {
          "href": "https://partners.liquid.com/api/v1/settlement/status/e875f3dd-d451-45df-a11f-9d1a31cd0353"
        }
      }
    },
    "_links": {
      "status": {
        "href": "https://partners.liquid.com/api/v1/transaction/status/3be28d7a-dc2a-4318-b9e8-3d21c1a1d221"
      }
    }
  }
}

Last updated