UniSat API Error Reference: Codes & Meanings

When working with the UniSat API, encountering errors is a natural part of the development process. To help you troubleshoot and resolve issues more efficiently, we've compiled a list of common error codes and their corresponding error messages.

This guide will help you quickly identify the cause of any errors and provide clarity on how to address them, ensuring a smoother integration and user experience.

// Some codeexport enum ErrorCode {
  _1 = -1,
  auction_not_exist = -100,
  auction_status_error = -101,
  bid_not_exist = -102,
  not_avaiable_utxo = -104,
  auction_create_error = -105,
  maintain = -106,
  nft_invalid = -107,
  inscription_not_found = -109,
  inscription_invalid = -110,
  inscription_info_fail = -111,
  sign_error = -112,
  bind_error = -113,
  domain_char_limit = -114,
  domain_sats_verify_error = -115,
  readonly = -116,

  transaction_not_found = -118,
  indexer_api_error = -119,
  fee_rate_too_low = -122,
  address_type_not_supoort = -124,
  invalid_nft_multi_inscriptions = -126,
  invalid_nft_not_confirmed = -127,
  buyers_sellers_is_same = -131,
  minimum_selling_price = -132,
  highest_selling_price = -133,
  first_bid_price_error = -137,
  bid_price_too_low = -138,
  fixed_price_error = -139,
  not_support_in_fixed_price_mode = -141,
  auction_is_started = -144,
  repeat_bid = -145,
  not_allowed_to_proceed = -147,
  blacklist_tip = -148,
  confirmations_num_to_be_traded = -150,
  confirmations_num_to_be_listed = -151,
  invalid_nft_unknown_type = -152,
  server_busy = -153,
  indexer_timeout = -154,
  seller_less_than_dust = -155,
  user_params_error = -156,
  batch_bid_not_support = -157,
  atomicals_api_error = -158,
  buyer_less_than_dust = -159,
  inscription_listed = -160,
  service_updated_try_again = -161,
  invalid_utxo = -162,
  public_address_inconsistent = -163,
  runes_api_error = -164,
  invalid_runes = -165,
  batch_listing_not_support = -166,
  dummy_utxo_not_enough = -167,
  dummy_split_only_support = -168,
}

export enum ErrorType {
  common = "common",
  unexpected = "unexpected",
}

export const transaction_not_found = "Transaction not found";
export const unisat_api_exception = "UniSat API data exception";
export const auction_not_exist = "Order not exist";
export const fee_rate_too_low = "Fee rate too low";
export const not_avaiable_utxo = "Available balance not enough";
export const address_type_not_supoort = "Address type not supported";
export const invalid_nft_multi_inscriptions = "Invalid NFT: multi inscriptions";
export const invalid_nft_unknown_type = "Invalid NFT: unknown type";
export const invalid_nft_not_confirmed = "Invalid NFT: not confirmed";
export const inscription_not_found =
  "Inscription not found, please try again later";
export const inscription_invalid = "Invalid inscription";
export const maintain_tip = "The system is under maintenance";

export const buyers_sellers_is_same = "Buyer and seller cannot be the same one";
export const minimum_selling_price_is_xxx =
  "The lowest listing amount of satoshis is "; // 50000
export const highest_selling_price_is_xxx =
  "The highest listing amount of satoshis is "; // 500_0000
export const first_bid_price_error = "First bid price error";
export const bid_price_too_low = "Bid price too low";
export const fixed_price_error =
  "The price has updated by the seller. Please refresh the page and try again.";
export const bid_id_not_exist = "Resource not available, please try again";
export const not_support_in_fixed_price_mode =
  "Not supported in fixed price mode";
export const auction_status_error = "Order status error";
export const auction_is_started = "The listing is not available anymore";
export const repeat_bid = "Repeated operation";
export const not_allowed_to_proceed = "You are not allowed to proceed";
export const black_tip =
  "System has automatically detected that you have engaged in malicious behavior, please contact Discord's management personnel";
export const domain_char_limit =
  "The domain name contains temporarily unsupported characters";
export const verify_domain_error = "Verify domain name error";
export const readonly_error = "The marketplace is currently not operational.";
export const price_has_been_set_incorrectly =
  "The price has been set incorrectly";
export const server_busy = "The service is busy, please wait.";
export const indexer_timeout = "Request indexer timeout, please retry.";
export const seller_less_than_dust =
  "Inscription value below min threshold (dust).";
export const user_params_error = "User params error: ";
export const batch_bid_not_support = "Bulk purchase not supported.";
export const buyer_less_than_dust =
  "This address cannot receive the inscription because it is less than dust, please try another address.";
export const inscription_listed =
  "Inscription is already listed on the market.";
export const service_updated_try_again =
  "The service is being updated, please try again.";
export const internal_error = "Internal error";
export const invalid_utxo = "Invalid UTXO";
export const utxo_is_spent = "UTXO is spent";
export const public_address_inconsistent =
  "The public key and address do not match.";
export const sign_error = "Sign error";
export const domain_type_error = "Domain type error";
export const init_price_error = "Price setting error";
export const invalid_runes = "Invalid runes";
export const batch_listing_not_support =
  "Bulk listing does not yet support this type of NFT";
export const indexer_api_error = "Indexer error, please try again later";
export const need_to_bind =
  "If you use the receive address, you need to bind first";
export const page_to_old = "The page is outdated, please refresh the page.";
export const dummy_utxo_not_enough = "The number of UTXO is not enough";
export const dummy_split_only_support =
  "Splitting UTXO currently only supports p2tr, p2sh, p2wpkh address types.";
export const feerate_too_low =
  "The network fee is too low, please increase the fee";
export const utxo_delay = "Indexing delayed, please try again later";