Skip to content
coinkun Docs API v1
Coinkun home Dashboard

Wallet

Create single-currency BTC, LTC, TRX or USDT TRC20 wallets with their own Wallet ID and Transfer Key, then receive payments, check balances and send transfers. A TRON wallet answers to trx-<hex> and usdt@trx-<hex>: both IDs share its addresses and key. The Dashboard opens a wallet by its Wallet ID on its currency's pages.

Examples use LTC unless stated otherwise. Use IDs and addresses for the selected currency.

On this page

#Create Wallet

POST /wallets Available

Create a wallet for one currency and receive its Wallet ID and Transfer Key. No authentication is required. Callback, service fee policy and auto transfer settings are optional.

URL
https://coinzaka.com/api/v1/wallets
Content type
application/json

Parameters

ParameterTypeDescriptionRequired
currencystringThe wallet's currency; a TRON wallet also answers to the other TRON currency. It cannot be changed. Allowed: btc, ltc, trx, usdt@trx, xmr.Required
callbacknull | object | objectMaximum 4096 canonical JSON bytes and nesting depth 8. HTTP(S) URL without credentials or fragment; method defaults to POST. Omitted or explicit-null data is stored and returned as null; receipt notification payloads use an empty object in that case. Explicit data objects are preserved. A null or omitted address callback inherits the current account or wallet default; an empty callback object disables it.Optional
processing-fee-policystringService fee policy. Default fixed. Allowed: percentage, fixed.Optional
destinationsnull | arrayInstant transfer recipients (up to 255). BTC/LTC percentages must total 100%; one omitted, null or empty amount receives the remainder (100% for a sole recipient). Ambiguous or zero remainders are rejected. Shares have at most two effective decimal places and responses contain explicit normalized percentages. TRX/USDT require one 100% destination. BTC/LTC settings are independent; TRX and USDT share settings in both Accounts and Wallets. Null disables new automatic transfers. Accepted payments retain their recipients and fees. Requires service activation for the selected currency.Optional
destination_rulesnull | arrayOne threshold or recurring rule with one recipient. Threshold sends the available balance once it reaches the atomic threshold. Recurring sends a fixed amount or percentage on a UTC schedule, at minute 0, using ISO weekdays (Sunday is 7) or month days 1-28 and L for the last day. Fees are deducted for Threshold and scheduled 100% sweeps, otherwise added on top; regular service fees apply. TRON reserves a complete cycle across up to 100 source addresses, with one cycle-wide service fee and aggregate fee limits. Null disables the rule.Optional
feestringAutomatic network fee strategy; TRX/USDT support normal only. Allowed: normal, priority, custom.Optional
fee-rateinteger | stringRequired only for custom. Positive integer atomic/vB; at most 99999 (Core accepts below one coin per 1,000 vbytes).Optional
curl --request POST "https://coinzaka.com/api/v1/wallets" \
  --header 'Content-Type: application/json' \
  --data-binary @- <<JSON
{
  "currency": "ltc",
  "callback": {
    "url": "${CALLBACK_URL:?Set CALLBACK_URL}",
    "method": "POST",
    "data": {}
  }
}
JSON

Bash: set CALLBACK_URL before running. Replace placeholders in the JSON Request tab. Responses are illustrative.

#Automatic Payment Activity

GET /wallets/{wallet}/auto-transfers Available

Read the wallet's paginated automatic payment activity, wait or skip reasons, next checks and payment links. Authentication is required.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/auto-transfers
Content type
application/json
Authorization
Wallet transfer-key in the query string, or an Authorization: Bearer access token from Login.

Parameters

ParameterTypeDescriptionRequired
walletstringRequired
transfer-keystringOptional
limitintegerOptional
offsetintegerOptional
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/auto-transfers" \
  --get \
  --data-urlencode "transfer-key=${TRANSFER_KEY:?Set TRANSFER_KEY}" \
  --data-urlencode "limit=10" \
  --data-urlencode "offset=0"

Bash: set WALLET_ID, TRANSFER_KEY before running. Responses are illustrative. Keep credentials on your server and out of shared code.

#Wallet Info

GET /wallets/{wallet} Available

Retrieve the wallet's public settings. No authentication is required.

URL
https://coinzaka.com/api/v1/wallets/{wallet}
Content type
application/json

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}"

Bash: set WALLET_ID before running. Responses are illustrative.

#Wallet Balance

GET /wallets/{wallet}/balance Available

Retrieve the wallet's total and available balance. Use addresses to restrict the result to selected receiving addresses.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/balance
Content type
application/json

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
addressesstringComma-separated owned receiving addresses, at most 100 entries before deduplication. Empty entries, spaces and malformed filters return 400; any missing, foreign or change address returns 404.Optional
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/balance"

Bash: set WALLET_ID before running. Responses are illustrative.

#Generate Address

POST /wallets/{wallet}/addresses Available

Generate a receiving address in the wallet's currency. No authentication is required. An optional callback overrides the wallet default for this address.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/addresses
Content type
application/json

Parameters

ParameterTypeDescriptionRequired
Idempotency-KeystringRequired for XMR; retry the same identical address intent.Optional
walletstringWallet ID returned by Create Wallet.Required
addr-typestringReceiving address format for the currency selected by the wallet ID. BTC defaults to p2sh-p2wpkh and also supports p2wpkh; LTC uses p2wpkh; TRX/USDT use generic (tron is accepted as an alias). Unsupported formats for the wallet currency return 400. Allowed: p2sh-p2wpkh, p2wpkh, generic, tron, monero.Optional
callbacknull | object | objectMaximum 4096 canonical JSON bytes and nesting depth 8. HTTP(S) URL without credentials or fragment; method defaults to POST. Omitted or explicit-null data is stored and returned as null; receipt notification payloads use an empty object in that case. Explicit data objects are preserved. A null or omitted address callback inherits the current account or wallet default; an empty callback object disables it.Optional
curl --request POST "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/addresses" \
  --header 'Content-Type: application/json' \
  --data-binary @- <<JSON
{
  "addr-type": "p2wpkh"
}
JSON

Bash: set WALLET_ID before running. Responses are illustrative.

#Address Info

GET /wallets/{wallet}/addresses/{address} Available

Retrieve the receiving address, creation date, address type and balance snapshot. No authentication is required.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/addresses/{address}
Content type
application/json

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
addressstringReceiving address belonging to the wallet.Required
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/addresses/${ADDRESS:?Set ADDRESS}"

Bash: set WALLET_ID, ADDRESS before running. Responses are illustrative.

#Address Balance

GET /wallets/{wallet}/addresses/{address}/balance Available

Retrieve total and available balances for one receiving address. No authentication is required.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/addresses/{address}/balance
Content type
application/json

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
addressstringReceiving address belonging to the wallet.Required
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/addresses/${ADDRESS:?Set ADDRESS}/balance"

Bash: set WALLET_ID, ADDRESS before running. Responses are illustrative.

#Wallet Addresses

GET /wallets/{wallet}/addresses Available

List the wallet's receiving addresses and their balances, newest first. Filter by address prefix or exclude empty addresses.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/addresses
Content type
application/json

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
limitintegerItems per page. Default 10; range 1 to 100.Optional
offsetintegerMatching items to skip. Default 0; maximum 10000.Optional
qstringOptional case-sensitive address prefix filter (address:prefix) and empty:false, once each, separated by a comma, in either order. A prefix contains 1 to 90 ASCII letters or digits; interior substrings and wildcards are not supported. empty:false excludes addresses whose saved total balance is zero, including a zero total with a nonzero shortfall. Negative totals remain included. Omit empty:false, or send empty:true, to inspect zero-total addresses. Other filters are rejected with 400.Optional
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/addresses" \
  --get \
  --data-urlencode "limit=10" \
  --data-urlencode "offset=0"

Bash: set WALLET_ID before running. Responses are illustrative.

#Estimate Transfer

GET /wallets/{wallet}/transfer Available

Preview recipient amounts, network fees and service fees before sending a payment from the wallet. An estimate does not reserve funds.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/transfer
Content type
application/json

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
destinationsstring1..100 comma-separated address:amount pairs. Amount is integer atomic units or a percentage (up to eight decimal places) of verified available source funds before fees.Required
addressesstringUp to 100 owned source addresses, comma-separated. BTC/LTC accept receiving and change addresses. The payment and fees use only selected funds; insufficient funds never widen the selection. TRX/USDT spend own receiving addresses: without addresses one recipient is paid by the smallest address that covers it alone (ties by address creation); otherwise, the given or all own addresses pay in order of available funds, the largest first, each part a separate transaction (at most 20 parts). A percentage is a share of the available balance of those addresses.Optional
feestringNetwork fee strategy. Default normal. TRX/USDT accept priority, custom and fee-rate and price, save and answer them as normal. Allowed: normal, priority, custom.Optional
fee-rateintegerRequired only for custom; integer atomic/vbyte, at most 99999 (Core accepts below one coin per 1,000 vbytes).Optional
subtract-fee-from-amountbooleanDeduct network and service fees from recipient amounts. Default false; one normalized 100% recipient forces true for every currency, including USDT, even with false or omission.Optional
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/transfer" \
  --get \
  --data-urlencode "destinations=${DESTINATION_ADDRESS:?Set DESTINATION_ADDRESS}:100000"

Bash: set WALLET_ID, DESTINATION_ADDRESS before running. Responses are illustrative.

#Transfer

POST /wallets/{wallet}/transfer Available

Send a payment from the wallet balance. Authorize with the wallet's Transfer Key or an access token from a wallet login.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/transfer
Content type
application/json
Authorization
Wallet transfer-key in the JSON body, or an Authorization: Bearer access token from Login.

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
Idempotency-KeystringOptional request identifier of 16 to 128 letters, digits, underscores or hyphens. Reuse only for an identical request.Optional
transfer-keystringRequired unless an Authorization Bearer access token is sent.Optional
fee-limitinteger | stringMaximum network fee in atomic units. Must be positive. Omit to use the fresh estimate. BTC/LTC also enforce a non-overridable network fee ceiling per transaction of 100000 satoshi / 1000000 litoshi, respectively; a lower client limit remains binding.Optional
processing-fee-limitinteger | stringMaximum service fee in atomic units. Omitted means freeze the current tariff quote; zero disallows a service fee.Optional
destinationsarray1..100 recipient address and amount pairs. Amounts are atomic integers or percentages of verified available source funds before fees.Required
addressesarray | stringOwned source addresses as an array or comma-separated string. BTC/LTC accept receiving and change addresses. The payment and fees use only selected funds; insufficient funds never widen the selection. TRX/USDT spend own receiving addresses: without addresses one recipient is paid by the smallest address that covers it alone (ties by address creation); otherwise, the given or all own addresses pay in order of available funds, the largest first, each part a separate transaction (at most 20 parts). A percentage is a share of the available balance of those addresses.Optional
feestringNetwork fee strategy. Default normal. TRX/USDT accept priority, custom and fee-rate and price, save and answer them as normal. Allowed: normal, priority, custom.Optional
fee-rateinteger | stringPositive integer atomic/vbyte, at most 99999 (Core accepts below one coin per 1,000 vbytes). Required only for custom.Optional
subtract-fee-from-amountbooleanDeduct both fees from recipient amounts. Default false; one normalized 100% recipient forces true for every currency, including USDT, even with false or omission.Optional
curl --request POST "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/transfer" \
  --header 'Content-Type: application/json' \
  --data-binary @- <<JSON
{
  "transfer-key": "${TRANSFER_KEY:?Set TRANSFER_KEY}",
  "destinations": [
    {
      "address": "${DESTINATION_ADDRESS:?Set DESTINATION_ADDRESS}",
      "amount": 100000
    }
  ],
  "fee": "normal",
  "subtract-fee-from-amount": false
}
JSON

Bash: set WALLET_ID, TRANSFER_KEY, DESTINATION_ADDRESS before running. Replace placeholders in the JSON Request tab. Responses are illustrative. Keep credentials on your server and out of shared code.

#Wallet History

GET /wallets/{wallet}/history Available

List the wallet's incoming receipts and outgoing payments. Filter by item type, address and date.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/history
Content type
application/json

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
qstringComma-separated item-type (receipt or payment), address, date-from and date-to filters, each once. Dates are inclusive ISO 8601 timestamps; an omitted timezone means UTC.Optional
addressesstringComma-separated list of 1–100 exact owned addresses. Selects whole receipt groups and payments spending from these addresses, preserving original amounts. Intersects q; applied before pagination. Unknown or foreign addresses match no items.Optional
limitintegerItems per page. Default 10; maximum 100.Optional
offsetintegerMatching items to skip. Default 0; maximum 10000.Optional
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/history" \
  --get \
  --data-urlencode "q=item-type:receipt,date-from:2026-10-01T00:00:00Z" \
  --data-urlencode "limit=10" \
  --data-urlencode "offset=0"

Bash: set WALLET_ID before running. Responses are illustrative.

#Wallet History Item

GET /wallets/{wallet}/history/{HistoryItemID} Available

Retrieve a receipt's receiving outputs or a payment's recipients, fees and transaction IDs using its 64-character hexadecimal ID.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/history/{HistoryItemID}
Content type
application/json

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
HistoryItemIDstringReceipt transaction hash or payment ID, as 64 hexadecimal characters.Required
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/history/${HISTORY_ITEM_ID:?Set HISTORY_ITEM_ID}"

Bash: set WALLET_ID, HISTORY_ITEM_ID before running. Responses are illustrative.

#Address History

GET /wallets/{wallet}/addresses/{address}/history Available

List incoming and outgoing transactions for one receiving address, newest first. Amounts show the net movement at that address in atomic units.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/addresses/{address}/history
Content type
application/json

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
addressstringReceiving address belonging to the wallet.Required
limitintegerItems per page. Default 10; maximum 100.Optional
offsetintegerMatching items to skip. Default 0; maximum 10000.Optional
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/addresses/${ADDRESS:?Set ADDRESS}/history" \
  --get \
  --data-urlencode "limit=10" \
  --data-urlencode "offset=0"

Bash: set WALLET_ID, ADDRESS before running. Responses are illustrative.

#Wallet Callback

GET /wallets/{wallet}/callback Available

Retrieve the wallet's callback configuration. Authentication is required.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/callback
Content type
application/json
Authorization
Wallet transfer-key in the query string, or an Authorization: Bearer access token from Login.

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
transfer-keystringRequired unless an Authorization Bearer access token is sent.Optional
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/callback" \
  --get \
  --data-urlencode "transfer-key=${TRANSFER_KEY:?Set TRANSFER_KEY}"

Bash: set WALLET_ID, TRANSFER_KEY before running. Responses are illustrative. Keep credentials on your server and out of shared code.

#Address Callback

GET /wallets/{wallet}/addresses/{address}/callback Available

Retrieve the effective callback configuration for a receiving address, including any wallet default. Authentication is required.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/addresses/{address}/callback
Content type
application/json
Authorization
Wallet transfer-key in the query string, or an Authorization: Bearer access token from Login.

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
addressstringReceiving address belonging to the wallet.Required
transfer-keystringRequired unless an Authorization Bearer access token is sent.Optional
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/addresses/${ADDRESS:?Set ADDRESS}/callback" \
  --get \
  --data-urlencode "transfer-key=${TRANSFER_KEY:?Set TRANSFER_KEY}"

Bash: set WALLET_ID, ADDRESS, TRANSFER_KEY before running. Responses are illustrative. Keep credentials on your server and out of shared code.

#Callback Log

GET /wallets/{wallet}/addresses/{address}/callback-log Available

List callback delivery attempts for a receiving address, newest first. Authentication is required.

URL
https://coinzaka.com/api/v1/wallets/{wallet}/addresses/{address}/callback-log
Content type
application/json
Authorization
Wallet transfer-key in the query string, or an Authorization: Bearer access token from Login.

Parameters

ParameterTypeDescriptionRequired
walletstringWallet ID returned by Create Wallet.Required
addressstringReceiving address belonging to the wallet.Required
transfer-keystringRequired unless an Authorization Bearer access token is sent.Optional
limitintegerItems per page. Default 10; maximum 100.Optional
offsetintegerMatching items to skip. Default 0; maximum 10000.Optional
curl --request GET "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}/addresses/${ADDRESS:?Set ADDRESS}/callback-log" \
  --get \
  --data-urlencode "transfer-key=${TRANSFER_KEY:?Set TRANSFER_KEY}" \
  --data-urlencode "limit=10" \
  --data-urlencode "offset=0"

Bash: set WALLET_ID, ADDRESS, TRANSFER_KEY before running. Responses are illustrative. Keep credentials on your server and out of shared code.

Coinkun API v1

Turning a preference off removes its saved values from this browser. It does not delete an account, change a payment or lock your current session. Read the storage details.

Type to search the documentation

↑↓ navigate↵ openesc close