GUIDE
HOW TO USE CAT


Login



First time you start C.A.T. you will get an Empty Login GUI
- Insert your private and your public key and press Enter
- C.A.T. verify if your public key is the key of your personal copy
- C.A.T. will communicate with public key + private key to Cryptsy to get Server Time

If everything goes well you will see this screen



- C.A.T. will write an XML file in your C.A.T. program folder called KEY.xml
- Next time you log on C.A.T. the private/public key will be in the textbox and the only action you must do is press "Enter"
- If you delete KEY.xml C.A.T. will restart with empty input-box.

Load/Save Markets



Once you have open a market, and create a ping-pong algo, you can save all the parameter and configuration in XML Format.
The save operation will save all the markets that have a Ping Pong Algorithm Active.
The load operation can be done only when there are no open markets. C.A.T. will make an automatic "Check" on each Market Loaded. 

General Markets Lookup



First Empty Screen you will see is General Market Lookup.
You can choose to load the markets from Cryptsy : All Markets/only BTC Markets/only LTC Markets/only XPM Markets
If you check the box "With Statistic Calculation" C.A.T. will calculate some additional statistics over the orders/trades (this operation is longer than the normal market load process)

These are the statistics calculated :
- % Difference is the difference between High/Low Trades of the last 24Hours
- Sell Order/Buy Order are the numbers of currently orders
- Sell Trade/Buy Trade 24H is the numbers of trades in the last 24Hours

You can sort this table in Ascending/Descending Order by clicking on the Column Header
Double Click On a Row will Open a new Tab for the selected Market in "My Markets" Panel.

My Balances



If you want to check your balances press the button "Load Balances"
Positive Balances are highlighted in green.
You can sort the table by Currency Name or by Balance Amount

Estimated Portfolio Values is calculated this way :
BTC Amount + Sum(Of All BTC Market Alt Curr * lastMarketPrice)+Sum(Of All Only-LTC Market Alt Curr * lastMarketPrice)+Sum(Of All Only-XPM Market Alt Curr * lastMarketPrice)

My Markets - Market General Status




In the Market General Status Tab, you can update the market status.
It's not mandatory to use, but if you want to have a look at the current market status without go on Cryptsy site and have all trades divided by "Buy/Sell", the only thing you must do is press the "Refresh Status Button" and wait some seconds.

These are the info displayed :
- Market current Orders
- Your current Orders
- Last Trades (Divided Buy/Sell)
- Your Last Trades (Divided Buy/Sell)

My Markets - Algorithms



This is where you create the Ping-Pong Algo.
There are 3 Mode : Static, Normal And Aggressive.

NORMAL MODE
- Min % Guaranteed Gain. Is the minimal % of GAIN you want guaranteed from C.A.T. after a Buy-Sell/Sell-Buy operation. If this percentage is not guaranteed, C.A.T. will wait.
- Skip Orders With Total < Than. With this Option Active C.A.T. during his Algorithm will not consider orders with total amount lower than the parameter value.
- Don't create ping with total < Than. After a successfull Ping-Pong the total amount of this order will be put in the "Cauldron" and from the "Cauldron" will be created new sell/buy orders. With this option activated you will limit the creation on "little orders". If total in Cauldron will be < than this parameter, C.A.T. will wait for more money in cauldron.
- Never Sell Under/Never Buy Over with this option activated you will limit the creaton of orders with price too low or too high.
- Sell All If Price Goes Under (Works only for Sell Orders) with this option activated C.A.T. will sell your order if the market price is too low. The sell price will be current the best buy price.
- Sell All If % With Ref Price Is : (Works only for Sell Orders) Each PONG orders have a reference Price : the sell/buy price of the Original Pong Orders. C.A.T. during the algo calculate the % difference between the reference price and the current best Buy/Sell Orders. With this option activated you decide to sell a Pong Order if the % calculated is too negative. A Suggestion is to use value lower than -5%
- Stop Ping Creation If Sell Value Is > : You can decide to Stop The ping Order Creation if the Current Best Sell Value if too high, C.A.T. will restart Ping Order Creation if the Best Sell Values return lower than your parameter
- Stop Ping Creation If Buy Value Is < : You can decide to Stop The ping Order Creation if the Current Best Buy Value if too logw, C.A.T. will restart Ping Order Creation when the Best Buy Value return higher than your parameter
- Never Buy/Sell Directly with this option you will never buy/sell directly and you orders will have 0.00000001 difference from the best Buy/Sell orders.

STATIC MODE
Choose a fixed price for Buy/Sell and C.A.T. will always Buy/Sell at these prices, without any adjustment.

AGGRESSIVE MODE
You must set only Min % Guaranteed Gain, C.A.T. will try always to made a successfull Ping-Pong Algo

Press the CHECK Button in the CALCULATOR if you want to :
- Know the % Difference between the Lowest Sell Price & The Higher Buy Price
- A Suggestion about the price to start a Sell/Buy Orders (accordingly to the algo parameter you have set)

GENERATE PING-PONG Algo With the first orders.
- Choose Type+Price+Quantity and press ADD PING ORDER (repeat for each order you want to create)
- Press the ADD NEW PING ORDERS button and C.A.T will start to Work.

DURING PING-PONG RUNNING
- You can Update All Your Parameter
- You can add New Ping Orders.


My Markets - Running Algorithms



After the Creation of a Ping-Pong Algo you will start to see an automatic log about all operation C.A.T. is doing : order check, order creation/re-creation, market condition etc...
In the Bottom Table there are the Ping-Pong success over the current Market

In this panel you can :
- Stop The Ping Pong Process
- Stop/Restart The Creation of new Ping Orders (current orders over the market will remain active)
- Close All Orders over the current market
- Close All Ping Orders over the current market

All operation are processed as soon as possible. This means that if the Ping-Pong "lookup" is running in that moment, CAT Will wait for the end.

General Log Gain



In the general log gain you can see all the Gain obtained by a Ping-Pong
You can read a line this way :

Example :
2013-09-19 17:46:47 - ANC/BTC - Buy 27.91787000@0.00244701 -> Sell 24.14541000@0.00247489 Gain 0.00037573 Fee 0.00029743 (0.00011816+0.00017927) Total Gain 0.02556899 Cumulative Gain 0.07712250

- 2013-09-19 17:46:47 Time Stamp on you PC. It's time time when a Pong order is selled/buyed.
- ANC/BTC The Market
- Buy 27.91787000@0.00244701 Original Order Quantity@Price
- Sell 24.14541000@0.00247489 Pong Order (or Part Of It) Born from the Original Order
- Gain 0.00037573
- Fee 0.00029743 (0.00011816+0.00017927) Total fee distributed on the 2 orders. The first fee is proportional to the second order.
- Total Gain 0.02556899 (Is the GAIN In ANC/BTC Market)
- Cumulative Gain 0.07712250 Is the Total Gain of C.A.T. in All Markets.

Analyzer

Market Analyzer is a tool created for compare market currencies values taken at different times.
And also to give you an hand to choose "massive" buy/sell and sell/buy when currencies values are at your advantage.



- First things to do is Load Current Market Values (you can choose all values, or only BTC,LTC,XPM)
- If you are going to sell/buy, set in the table : Action + Price + Quantity
- Save the Snapshot (xml format)

When you want to make a compare you must load 2 Market Snapshot, and then decide (select the snapshots from the combobox in the botton of Analyzer Panel) which market is the market FROM and which is the market TO. Then press COMPARE Button



Each value from the Snapshot FROM will be compare against the same value in Snapshot TO.
If Value is higher you will see in GREEN Color
If Value is lower you will see in RED Color
If you have set a BUY/SELL operation in the Snapshot FROM, you will also see a estimated value of how much can you gain/lose if you sell/buy now your previous buy/sell orders.


Console Error



Is the console where all System Errors Are Listed many of the are only warnings because C.A.T. is able to recover these errors.

HTTP ERROR Connection timed out: connect RETRY IN 10 Seconds
Your adsl line is Down/Cryptsy doesn't response? No problem, C.A.T will retry.

Call Retry Json Exception Unterminated string at xxxxxx...............
It's a JSON result bad formatted. It rarely happens, but the call will be retried.

Call Aborted! Json Result Error during createorder Call Is Aborted After 25 retry
It happens when the orders creation, after 25 Retry is failed. Usually is because there are no money in wallet. C.A.T. will try to recreate an order with lower quantity at the same price.

HTTP ERROR Server returned HTTP response code: 502 for URL: https://www.cryptsy.com/api
Cryptsy Error. Call Will Be Retried.

XPM/BTC (Or Any Other Market) Error Lookup Market Better Restart Market
This is usually an internal Error. Is Very Rare but i can do some code improvements to find and resolve.