Get transaction

curl --request GET \
  --url https://api.kraken.com/v0/insto/custody/vaults/{vault_id}/transactions/{transaction_id} \
  --header 'api-key: <api-key>' \
  --header 'api-nonce: <api-key>' \
  --header 'api-sign: <api-key>'

import requests

url = "https://api.kraken.com/v0/insto/custody/vaults/{vault_id}/transactions/{transaction_id}"

headers = {
    "api-key": "<api-key>",
    "api-sign": "<api-key>",
    "api-nonce": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'api-key': '<api-key>', 'api-sign': '<api-key>', 'api-nonce': '<api-key>'}
};

fetch('https://api.kraken.com/v0/insto/custody/vaults/{vault_id}/transactions/{transaction_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kraken.com/v0/insto/custody/vaults/{vault_id}/transactions/{transaction_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api-key", "<api-key>")
	req.Header.Add("api-sign", "<api-key>")
	req.Header.Add("api-nonce", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "TXABCDE-FGHIJ-KLMNO2",
  "type": "deposit",
  "status": "completed",
  "asset": "BTC",
  "asset_class": "currency",
  "amount": "1.25",
  "time": "2024-05-14T22:13:20.000Z",
  "transaction_hash": "0x4a7d1ed414474e4033ac29ccb8653d9b00d3f1c9a3b7e5d2c8f6a4b1e9d7c5a3",
  "ref_id": "FTABCDE-FGHIJ-KLMNO2",
  "fee_amount": "0.01",
  "fee_asset": "BTC",
  "fee_asset_class": "currency",
  "extension_type": "post_trade_settlement"
}

{
  "type": "tag:kraken.com,2025:BadRequest",
  "status": 400,
  "title": "Bad Request",
  "data": {
    "message": "Request failed validation."
  },
  "detail": "Request failed validation.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:PermissionDenied",
  "status": 403,
  "title": "Forbidden",
  "data": {
    "message": "Caller lacks access to the requested resource."
  },
  "detail": "Caller lacks access to the requested resource.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:gateway/ReadUpstream",
  "status": 500,
  "title": "Internal Server Error",
  "data": "<unknown>",
  "detail": "Failed to read response from upstream custody service.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:gateway/Connect",
  "status": 503,
  "title": "Service Unavailable",
  "data": "<unknown>",
  "detail": "Downstream custody service is temporarily unreachable.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

GET

insto

custody

vaults

{vault_id}

transactions

{transaction_id}

Get transaction

curl --request GET \
  --url https://api.kraken.com/v0/insto/custody/vaults/{vault_id}/transactions/{transaction_id} \
  --header 'api-key: <api-key>' \
  --header 'api-nonce: <api-key>' \
  --header 'api-sign: <api-key>'

import requests

url = "https://api.kraken.com/v0/insto/custody/vaults/{vault_id}/transactions/{transaction_id}"

headers = {
    "api-key": "<api-key>",
    "api-sign": "<api-key>",
    "api-nonce": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'api-key': '<api-key>', 'api-sign': '<api-key>', 'api-nonce': '<api-key>'}
};

fetch('https://api.kraken.com/v0/insto/custody/vaults/{vault_id}/transactions/{transaction_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kraken.com/v0/insto/custody/vaults/{vault_id}/transactions/{transaction_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api-key", "<api-key>")
	req.Header.Add("api-sign", "<api-key>")
	req.Header.Add("api-nonce", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "TXABCDE-FGHIJ-KLMNO2",
  "type": "deposit",
  "status": "completed",
  "asset": "BTC",
  "asset_class": "currency",
  "amount": "1.25",
  "time": "2024-05-14T22:13:20.000Z",
  "transaction_hash": "0x4a7d1ed414474e4033ac29ccb8653d9b00d3f1c9a3b7e5d2c8f6a4b1e9d7c5a3",
  "ref_id": "FTABCDE-FGHIJ-KLMNO2",
  "fee_amount": "0.01",
  "fee_asset": "BTC",
  "fee_asset_class": "currency",
  "extension_type": "post_trade_settlement"
}

{
  "type": "tag:kraken.com,2025:BadRequest",
  "status": 400,
  "title": "Bad Request",
  "data": {
    "message": "Request failed validation."
  },
  "detail": "Request failed validation.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:PermissionDenied",
  "status": 403,
  "title": "Forbidden",
  "data": {
    "message": "Caller lacks access to the requested resource."
  },
  "detail": "Caller lacks access to the requested resource.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:gateway/ReadUpstream",
  "status": 500,
  "title": "Internal Server Error",
  "data": "<unknown>",
  "detail": "Failed to read response from upstream custody service.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:gateway/Connect",
  "status": 503,
  "title": "Service Unavailable",
  "data": "<unknown>",
  "detail": "Downstream custody service is temporarily unreachable.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

Authorizations

api-key

string

header

required

api-sign

string

header

required

api-nonce

string

header

required

Path Parameters

vault_id

string

required

Vault identifier, a V-prefixed 14-char base32 string with a final check character.

Example:

"VABCDEF234567A"

transaction_id

string

required

Transaction identifier, as returned in the vault's transaction history.

Example:

"TXABCDE-FGHIJ-KLMNO2"

Response

The requested transaction.

string

required

Transaction identifier.

Example:

"TXABCDE-FGHIJ-KLMNO2"

type

string

required

Transaction type (e.g. deposit, withdrawal, custody_transfer).

Example:

"deposit"

status

string

required

Transaction status, resolved per the asset's crypto or fiat classification (e.g. pending, broadcast, completed, failed, settled, on_hold).

Example:

"completed"

asset

string

required

Asset code of the transaction amount.

Example:

"BTC"

asset_class

string

required

Asset class of the transaction amount (e.g. currency, tokenized_asset).

Example:

"currency"

amount

string

required

Transaction amount, fixed-precision decimal as string. Spend amounts are negative.

Example:

"1.25"

time

string

required

Transaction time (ISO-8601).

Example:

"2024-05-14T22:13:20.000Z"

transaction_hash

string

On-chain transaction hash, when available.

Example:

"0x4a7d1ed414474e4033ac29ccb8653d9b00d3f1c9a3b7e5d2c8f6a4b1e9d7c5a3"

ref_id

string

Reference identifier linking the transaction to its originating operation, when available.

Example:

"FTABCDE-FGHIJ-KLMNO2"

fee_amount

string

Fee amount charged for the transaction, fixed-precision decimal as string. Present when a fee applies.

Example:

"0.01"

fee_asset

string

Asset code the fee is charged in. Present when a fee applies.

Example:

"BTC"

fee_asset_class

string

Asset class of the fee asset (e.g. currency, tokenized_asset). Present when a fee applies.

Example:

"currency"

extension_type

string

Custody extension type for extended transactions (e.g. post_trade_settlement), when available.

Example:

"post_trade_settlement"

List transactions

⌘I

Assets (v0)

Organizations (v0)

Vaults (v0)

Deposits (v0)

Withdrawals (v0)

Tasks (v0)

Transactions (v0)

Get transaction

Authorizations

Path Parameters

Response