testnet

Home Help About Us Stats Create an Account Private Communication Person-to-Person Voucher

Verification levels

Kiwi-Coin supports developed and flexible verification levels system. Based on your time constraints and circumstances you can pick and choose what level suits you the most.

Depends on your overall account level you will have different withdrawal lock times and limits.

Functionality and limits:

Overall account level Crypto deposits Crypto withdraw Fiat
deposits/withdraw
24-hour withdrawal limit
(NZD equivalent)
30-days withdrawal limit
(NZD equivalent)
0 - AnonymousDisabledEnabledDisabled500.005000.00
1 - UnverifiedDisabledEnabledDisabled1000.0010000.00
2 - VerifiedEnabledEnabledEnabled4000.0060000.00
3 - TrustedEnabledEnabledEnabled100000.001000000.00

Levels' requirements:

  • 0 - Anonymous: Verified e-mail.
  • 1 - Unverified: Same as 0 - Anonymous, plus: filled all identity information, filled all address information, filled source of funds.
  • 2 - Verified: Same as 1 - Unverified, plus verified identity information, verified address information.
  • 3 - Trusted: Same as 2 - Verified, plus: hard copy documentary evidence of source of funds, Google Authenticator enabled.

How to become 2-Verified

To become 2-Verified You need both ID verification and Address verification.

ID verification

For 1.5-ID-Verified you only need to get your ID verified: Full.

For do that go to Account → Profile → Identity, press "Upgrade" and follow the instructions.

See below what we accept as proof of identity:

Here's the instruction for RealMe

Prove your identity with RealMe

You can securely prove who you are if you’ve already applied for verified identity and had your photo taken at a PostShop, or ticked verified identity with your recent passport renewal.


What’s RealMe?

The easy way to prove who you are online

RealMe is a service from the New Zealand government and New Zealand Post that allows you to prove who you are online.

How do I get a RealMe verified identity?

To get a RealMe verified identity you need to apply online at www.realme.govt.nz , then visit a PostShop in person, so your online identity can be linked to you.

When verify your identity, Kiwi-Coin is required to see at least one form of ID.

This is a legal requirement designed to protect you and Kiwi-Coin.

If you are unable to meet any of these requirements please contact us to discuss your options.

Acceptable customer ID

Your ID should be current and original and at least one of your forms of ID needs to contain a photo.

Choose from the following options:

ANY of the following:
  • Passport (NZ or overseas)
  • New Zealand Firearms license
  • Certificate of identity*
  • Refugee Travel Document*
  • National Identity Card
*Either issued by NZ Immigration Services or Department of Internal Affairs New Zealand containing one photographic image of holder

Where to send

For upgrade your identity level to the verified you have to post JP-certified copies of the documents listed above to the address:

------------------------------
Kiwi-Coin Limited
PO Box 42-053
Orakei
Auckland 1745
New Zealand
------------------------------

It the post envelope you should include a piece of paper with your signature and text:
"Please, verify my identity. My Kiwi-Coin account number: Your Account Number Goes Here"
A New Zealand drivers license AND ANY of the following:
  • SuperGold card*
  • Credit card – with name embossed*
  • Debit card – with name embossed*
  • Bank statement
  • Government agency statement
*Requires the name and signature to match drivers license

Where to send

For upgrade your identity level to the verified you have to post JP-certified copies of the documents listed above to the address:

------------------------------
Kiwi-Coin Limited
PO Box 42-053
Orakei
Auckland 1745
New Zealand
------------------------------

It the post envelope you should include a piece of paper with your signature and text:
"Please, verify my identity. My Kiwi-Coin account number: Your Account Number Goes Here"
ANY of the following:
  • New Zealand full birth certificate
  • Overseas full birth certificate
  • Certificate of New Zealand citizenship
  • Overseas citizenship certificate
AND
ANY
of the following:
  • New Zealand drivers license
  • Overseas drivers license (with photo) and valid international driving permit
  • 18+ Card
  • New Zealand Armed Forces ID
  • New Zealand Police ID
  • SuperGold card (with photo)

Where to send

For upgrade your identity level to the verified you have to post JP-certified copies of the documents listed above to the address:

------------------------------
Kiwi-Coin Limited
PO Box 42-053
Orakei
Auckland 1745
New Zealand
------------------------------

It the post envelope you should include a piece of paper with your signature and text:
"Please, verify my identity. My Kiwi-Coin account number: Your Account Number Goes Here"
For Photo ID identification, create a support ticket with ONE attached photo which have the three of the following:
  • Your face.
  • NZ driver license.
  • Piece of paper with manually written text: user's full name, Kiwi-Coin and today's date

Notes:

  • Use "Verification" as ticket type
  • Use "Photo Verification" as ticket subject
  • The photo MUST NOT be altered by any picture editing software. (Such as photoshop, paint, etc)
  • The text on the piece of paper should be clearly recognizable.
  • The details on driver license must be clearly recognizable.
  • MAKE SURE the file was attached to the ticket. When the file is attached, the downloadable link appears below the ticket body.


Address verification

To become 2-Verified you need to be Full ID Verified, plus you need to be Address Verified.

For do that go to Account → Profile → Address, press "Upgrade" and follow the instructions.

See below what we accept as proof of address:

Here's the instruction for RealMe

Prove your identity with RealMe

You can securely prove who you are if you’ve already applied for verified identity and had your photo taken at a PostShop, or ticked verified identity with your recent passport renewal.


What’s RealMe?

The easy way to prove who you are online

RealMe is a service from the New Zealand government and New Zealand Post that allows you to prove who you are online.

How do I get a RealMe verified identity?

To get a RealMe verified identity you need to apply online at www.realme.govt.nz , then visit a PostShop in person, so your online identity can be linked to you.

Note: If you verify your identity with RealMe, all of your identity and address detail, which you entered manually, will be overwritten by details which are provided by RealMe.

When verify your address, Kiwi-Coin is required to see ANY of the following documents that proves your physical address:

  • Utility statements (gas, power, fixed phone line and/or Internet)
  • Letter from a New Zealand educational institution
  • Local authorities rates or water bills
  • Tenancy agreements
  • Superannuation Scheme correspondence
  • Insurance policy document
  • Bank correspondence
  • Correspondence from one of the following Government agencies:
    • Inland Revenue Department
    • Ministry of Social Development (includes WINZ and Studylink)
    • New Zealand Police
    • Department of Corrections
    • Ministry of Immigration
    • Ministry of Justice
    • Accident Compensation Corporation
    • District Health Board
    • Department of Internal Affairs
    • Electoral Office
    • Department of Building and Housing (includes bond lodgement confirmations)
    • New Zealand Transport Authority (NZTA)

Where to send

For upgrade your address level to the "Verified" you have to post originals or JP-certified copies of one the documents listed above to the address:

------------------------------
Kiwi-Coin Limited
PO Box 42-053
Orakei
Auckland 1745
New Zealand
------------------------------

It the post envelope you should include a piece of paper with your signature and text:

"Please, verify my address. My Kiwi-Coin account number: Your Account Number Goes Here"

How to become 3-Trusted

To become 3-Trusted you need be 2-Verified and have a verified source of funds.

To upgrade source of funds level, please, create a support ticket with all scanned copies of your documents for source of funds verification attached to that ticket.

After investigating your documents we will ask you to post originals to the address:

------------------------------
Kiwi-Coin Limited
PO Box 42-053
Orakei
Auckland 1745
New Zealand
------------------------------

Documentary evidence might be: payslips, invoices if you're self employed. These documents could be scanned copies.

The above is required to be accompanied with bank statements stamped by your bank with incoming transaction matching the evidence from your documentation. These documents should be originals.

Important: Documentary evidence should include payments for the past three month.

What's an example of a great 3-Trusted application?

  • A printed out payslip from accounting system of your employer (MYOB, Xero, etc) which shows your salary in form of take-home pay per fortnight/month
  • It goes with signed and stamped bank statements from your bank showing a couple of direct debits coming from your employer which match the exact figures from your payslip.
  • Coming in an envelop with a piece of paper indicating your Kiwi-Coin account id.

API description

What is API?

Kiwi-Coin's Application Programming Interface (API) allows our clients to access and control their accounts using custom written software.

Request limits

Do not make more than 600 requests per 10 minutes or we will ban your IP address.

Public Data Functions

Ticker

GET https://kiwi-coin.org/api/ticker/

Returns JSON object:

  • last - last BTC price
  • date - price date
  • high - last 24 hours till date price high
  • low - last 24 hours till date price low
  • vwap - last 24 hours till date volume weighted average price: vwap
  • volume - last 24 hours till date volume
  • bid - highest buy order
  • ask - lowest sell order

Order book

GET https://kiwi-coin.org/api/order_book/

Returns JSON object:

  • bids - array of open bid orders. Each item is a array with two elements: price and amount
  • asks - array of open ask orders. Each item is a array with two elements: price and amount

API authentication

All private API calls require authentication. You need to provide 3 parameters to authenticate a request:

  1. API key
  2. Nonce
  3. Signature

API key

To get an API key, go to Account → API. Click Add new API key and set permissions.

Nonce

Nonce is a regular integer number. It must be increasing with every request you make. Read more about it here.

Example: if you set nonce to 1 in your first request, you must set it to at least 2 in your second request. You are not required to start with 1. A common practice is to use unix time for that parameter.

Signature

Signature is a HMAC-SHA256 encoded message containing concatenated:

  • Nonce
  • Users ID (can be found at the top of page, labeled "Id:")
  • API key
  • ";"
  • Request name
  • All the request's parameters (except key, signature and nonce) separated by ",". The order should be the same as in request's description.

The HMAC-SHA256 code must be generated using a secret key that was generated with your API key. This code must be converted to it's hexadecimal representation (64 uppercase characters).

Example (shell):

							$ UserId='Your user Id'
							$ Key='Your API-Key'
							$ Secret='Your API-Key secret'
							$ Nonce="$(date '+%s')"
							$ Message="$Nonce$UserId$Key;balance"
							$ Signature="$(echo -n "$Message"|openssl dgst "-sha256" -hmac "$Secret"|awk '{print toupper($2)}')"
							$ curl --data "key=$Key&signature=$Signature&nonce=$Nonce" https://kiwi-coin.org/api/balance/
						

Example (python):

							>>> import time
							>>> import math
							>>> import hmac
							>>> import hashlib
							>>> import requests
							>>> UserId = "Your user Id"
							>>> Key = "Your API-Key"
							>>> Secret = "Your API-Key secret"
							>>> Nonce = math.trunc(time.time())
							>>> Message = str(Nonce) + str(UserId) + Key + ";trades,day"
							>>> Signature = hmac.new(Secret, msg=Message, digestmod=hashlib.sha256).hexdigest().upper()
							>>> R = requests.post("https://kiwi-coin.org/api/trades/", data={'key': Key, 'signature': Signature, 'nonce': Nonce, 'timeframe': "day"})
							>>> print(R.status_code, R.reason, R.text)
						

Example of buy order (shell):

							$ UserId='Your user Id'
							$ Key='Your API-Key'
							$ Secret='Your API-Key secret'
							$ Nonce="$(date '+%s')"
							$ Price='785' #note: 785.0 will not work, but 785.1 will
							$ Amount='2' #note: 2.0 will not work, but 2.1 will
							$ Message="$Nonce$UserId$Key;buy,$Price,$Amount"
							$ Signature="$(echo -n "$Message"|openssl dgst "-sha256" -hmac "$Secret"|awk '{print toupper($2)}')"
							$ curl --data "key=$Key&signature=$Signature&nonce=$Nonce&price=$Price&amount=$Amount" https://kiwi-coin.org/api/buy/
						

Private Functions

Account balance

POST https://kiwi-coin.org/api/balance/

Params:

  • key - API key
  • signature - signature
  • nonce - nonce

Returns JSON object:

  • nzd_balance - NZD balance
  • btc_balance - BTC balance
  • nzd_reserved - NZD reserved in open orders or waiting withdrawals
  • btc_reserved - BTC reserved in open orders or waiting withdrawals
  • nzd_available- NZD available for trading
  • btc_available - BTC available for trading
  • fee - customer trading fee

Open orders

POST https://kiwi-coin.org/api/open_orders/

Params:

  • key - API key
  • signature - signature
  • nonce - nonce

Returns JSON array of open orders. Each order is represented as object:

  • id - order id
  • datetime - date and time
  • type - buy or sell (0 - buy; 1 - sell)
  • price - price
  • amount - amount

List of trades

POST https://kiwi-coin.org/api/trades/

Params:

  • key - API key
  • signature - signature
  • nonce - nonce
  • timeframe (optional) - time frame, can be: "minute", "hour", "day", "all". Default: "hour"

Returns JSON array of trades happened. Each trade is represented as object:

  • transaction_id - internal transaction ID
  • datetime - date and time in unix format
  • trade_type - buy or sell (0 - buy; 1 - sell)
  • trade_size - size of trade in XBT
  • price - price of trade in NZD for one XBT
  • income - amount of XBT (for buy) or NZD (for sell) you have got
  • fee - trading fee you have paid in XBT (for buy) or NZD (for sell)

Cancel order

POST https://kiwi-coin.org/api/cancel_order/

Params:

  • key - API key
  • signature - signature
  • nonce - nonce
  • id - order ID

Returns 'true' if order has been found and canceled.

Buy limit order

POST https://kiwi-coin.org/api/buy/

Params:

  • key - API key
  • signature - signature
  • nonce - nonce
  • price - price
  • amount - amount

Returns JSON object representing an order:

  • id - order id
  • datetime - date and time
  • type - buy or sell (0 - buy; 1 - sell)
  • price - price
  • amount - amount

Sell limit order

POST https://kiwi-coin.org/api/sell/

Params:

  • key - API key
  • signature - signature
  • nonce - nonce
  • price - price
  • amount - amount

Returns JSON object representing an order:

  • id - order id
  • datetime - date and time
  • type - buy or sell (0 - buy; 1 - sell)
  • price - price
  • amount - amount

Floating Orders

Usually when buying or selling XBT with limit order, you set a fixed price by which you want to buy or sell, so, if market condition is changing, you have to monitor that and change your price by manually canceling the old and creating a new order.

With Floating Order, you don't specify a fixed price. Rather than that, you specify a range of acceptable prices, source of basic price and "± % from basic price". Source of basic price can be two: "Worldwide average" or Europe.

Once created, the floating order will be continuing automatically update it's price within the acceptable price ranges if basic price is changing, so that you don't have to reset the order manually all the time.

The system will check the basic price every minute and will change the order price if basic price has been changed.

The order price is calculated as "± %" which you set either from the Worldwide market price or Europe, either one you choose.

Frequently Asked Questions

    • Overall account level 2-Verified is required.
    • If you are going to withdraw NZD, verify your bank account first. Follow instructions on Withdrawal page.
    • Create an Account
    • Wait for your account activation email.
    • Continue from the email and set your new password.
    • Login into your new account.
    • Fill out all the Identity fields in your profile (Account → Profile) with real info.
    • Fill out all the Address and Source of Funds fields with real info
    • Verify your account. You need 2-Verified (NZD$4000.00/day, NZD$60000.00/month for deposits/withdrawals). More info on verification levels here. You have a choice:
      • RealMe verification (We are strongly advice to use this one)
      • Post your verification documents to our PO Box (see the instructions here)
    • After that is done, you can deposit NZD. You have a choice:
      • Deposit instantly via POLi. You can start on the Deposit page and continue using POLi. Be aware: you will need to submit your online banking username and password to POLi (Note: After you completed POLi payment your Kiwi-Coin account will be credited ONLY after you click "Check incoming deposits").
      • Verify your bank account. Add your bank account on the Deposit page, press "Verify" and follow the instruction. Then direct debit to our bank account (as specified on the Deposit page). This will be processed in around 2 business days.
    • Wait for your deposit to arrive and be cleared. This step is skipped when using POLi.
    • Make a bid order on the Buy page. In order to buy quickly, make a simple order which would be bought out using what's available on the exchange. If you want to wait for a specific price though, you can make an Advanced order.
    • Create an Account
    • Wait for your account activation email.
    • Continue from the email and set your new password.
    • Login into your new account.
    • Fill out all the Identity fields in your profile (Account → Profile) with real info.
    • Fill out all the Address and Source of Funds fields with real info
    • Verify your account. You need 2-Verified (NZD$4000.00/day, NZD$60000.00/month for deposits/withdrawals). More info on verification levels here. You have a choice:
      • RealMe verification (We are strongly advice to use this one)
      • Post your verification documents to our PO Box (see the instructions here)
    • Verify your bank account. Add your bank account on the Withdrawal page, press "Verify" and follow the instruction.
    • Deposit some bitcoins on the Deposit page. Wait when there are enough network confirmations for that to process.
    • Make an ask order on the Sell page. In order to sell quickly, make a simple order which would be sold using what's available on the exchange. If you want to wait for a specific price though, you can make an Advanced order.
    • Make a withdrawal to the bank account which you have verified. Withdrawals are processed in around 1 business day, if it takes too long please contact support.
  1. Head over to the Private Communication page and ask for a password reset.

    We will ask you several questions to be sure it's your account.

    ATTENTION! After a password reset, withdrawal will be locked for 30 days. The lock can be released after a personal meeting to which customer must bring an ID (any form of id as specified in ID verification rules).

  2. Head over to Verification levels page to read in-depth explanation.

  3. Withdrawal limit for BTC/NZD is counted in equivalent of NZD according to market price. Exact limits are applied based on your verification level. Here are more details on Verification levels.

  4. Try leaving more time for the code to expire, ideally pressing enter at the middle of the expiration period. The clock on your phone and the Internet time might be out of sync. The time on your phone should be the same as the Internet time, +- 5 seconds.

  5. ------------------------------
    Kiwi-Coin Limited
    PO Box 42-053
    Orakei
    Auckland 1745
    New Zealand
    ------------------------------

  6. Account -> Profile -> Notifications

  7. First of all, we sorry to see you go. Create a ticket stating the problem you are having, and message online support to have that ticket looked into quicker. But if you really want to delete your account, create a ticket asking that.

  8. Use Private Chat page. You can contact us on the page either via a support ticket, or if there's an urgent matter, via Online Support. More info on contacting us can be found on Contact & Feedback page