diff --git a/doc/api/api.md b/doc/api/api.md
new file mode 100644
index 000000000..b7621f19b
--- /dev/null
+++ b/doc/api/api.md
@@ -0,0 +1,20 @@
+# Grin API Documentation
+
+This document contains the documentation for the 3 Grin REST APIs. These endpoints can be grouped in two categories.
+
+## Node API
+
+This endpoint is used to query a node about various information on the blockchain, networks and peers. By default, this REST API will listen on `localhost:13413`. This API is started as the same time as the Grin node.
+To learn about what specific calls can be made read the [node API doc](node_api.md).
+
+## Wallet APIs
+
+### Foreign Wallet API
+
+The foreign API is an endpoint mainly designed to receiving grins through a network. This REST API can be started with the `grin wallet listen` command and by default will listen on `localhost:13415`.
+To learn about what specific calls can be made read the [wallet foreign API doc](wallet_foreign_api.md).
+
+### Wallet Owner API
+
+The wallet owner API is an endpoint to manage the user wallet: broadcast transaction, sign transaction, see the current balance... This REST API can be started with the `grin wallet owner_api` command and will listen on `localhost:13420`. This endpoint must **never** be exposed to the outside world.
+To learn about what specific calls can be made read the [wallet owner API doc](wallet_owner_api.md).
diff --git a/doc/api/node_api.md b/doc/api/node_api.md
new file mode 100644
index 000000000..3b01faac6
--- /dev/null
+++ b/doc/api/node_api.md
@@ -0,0 +1,1147 @@
+# Node API Documentation
+
+## Table of Contents
+
+1. [Blocks Endpoint](#blocks-endpoint)
+    1. [GET Blocks](#get-blocks)
+1. [Headers Endpoint](#headers-endpoint)
+    1. [GET Headers](#get-headers)
+1. [Chain Endpoint](#chain-endpoint)
+    1. [GET Chain](#get-chain)
+    1. [POST Chain Compact](#post-chain-compact)
+    1. [POST Chain Validate](#post-chain-validate)
+    1. [GET Chain Outputs by IDs](#get-chain-outputs-by-ids)
+    1. [GET Chain Outputs by Height](#get-chain-outputs-by-height)
+1. [Status Endpoint](#status-endpoint)
+    1. [GET Status](#get-status)
+1. [TxHashSet Endpoint](#txhashset-endpoint)
+    1. [GET TxHashSet Roots](#get-txhashset-roots)
+    1. [GET TxHashSet Last Outputs](#get-txhashset-last-outputs)
+    1. [GET TxHashSet Last Range Proofs](#get-txhashset-last-range-proofs)
+    1. [GET TxHashSet Last Kernels](#get-txhashset-last-kernels)
+    1. [GET TxHashSet Outputs](#get-txhashset-outputs)
+    1. [GET TxHashSet Merkle Proof](#get-txhashset-merkle-proof)
+1. [Pool Endpoint](#pool-endpoint)
+    1. [GET Pool](#get-pool)
+    1. [POST Pool Push](#post-pool-push)
+1. [Peers Endpoint](#peers-endpoint)
+    1. [POST Peers Ban](#post-peers-ban)
+    1. [POST Peers Unban](#post-peers-unban)
+    1. [GET Peers All](#get-peers-all)
+    1. [GET Peers Connected](#get-peers-connected)
+    1. [GET Peers](#get-peers)
+
+## Blocks Endpoint
+
+### GET Blocks
+
+Returns data about a specific block given a hash, a height or an unspent commit.
+Optionally return results as "compact blocks" by passing `?compact` query.
+
+* **URL**
+
+  /v1/blocks/hash
+  /v1/blocks/height
+  /v1/blocks/commit
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  **Required:**
+  `hash=[string]`
+  or
+  `height=[number]`
+  or
+  `commit=[string]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+    | Field                 | Type     | Description                                                                 |
+    |:----------------------|:---------|:----------------------------------------------------------------------------|
+    | header                | object   | The block header                                                            |
+    | - hash                | string   | Hash of the current block                                                   |
+    | - version             | number   | Version of the block                                                        |
+    | - height              | number   | Height of this block since the genesis block (height 0)                     |
+    | - previous            | string   | Hash of the block previous to this in the chain                             |
+    | - timestamp           | string   | RFC3339 timestamp at which the block was built                              |
+    | - output_root         | string   | Merklish root of all the commitments in the TxHashSet                       |
+    | - range_proof_root    | string   | Merklish root of all range proofs in the TxHashSet                          |
+    | - kernel_root         | string   | Merklish root of all transaction kernels in the TxHashSet                   |
+    | - nonce               | number   | Nonce increment used to mine this block                                     |
+    | - cuckoo_size         | number   | Size of the cuckoo graph                                                    |
+    | - cuckoo_solution     | []number | The Cuckoo solution for this block                                          |
+    | - total_difficulty    | number   | Total accumulated difficulty since genesis block                            |
+    | - total_kernel_offset | string   | Total kernel offset since genesis block                                     |
+    | inputs                | []string | Input transactions                                                          |
+    | outputs               | []object | Outputs transactions                                                        |
+    | - output_type         | string   | The type of output Coinbase|Transaction                                     |
+    | - commit              | string   | The homomorphic commitment representing the output's amount (as hex string) |
+    | - spent               | bool     | Whether the output has been spent                                           |
+    | - proof               | string   | Rangeproof (as hex string)                                                  |
+    | - proof_hash          | string   | Rangeproof hash (as hex string)                                             |
+    | - block_height        | number   | Block height at which the output is found                                   |
+    | - merkle_proof        | string   | Merkle proof                                                                |
+    | kernels               | []object | Transaction Kernels (a proof that a transaction sums to zero)               |
+    | - features            | string   | Rank of the user                                                            |
+    | - fee                 | number   | Hashrate of the user                                                        |
+    | - lock_height         | number   | Rank of the user                                                            |
+    | - excess              | string   | Hashrate of the user                                                        |
+    | - excess_sig          | string   | Rank of the user                                                            |
+
+* **Error Response:**
+
+  * **Code:** 404 or 500
+  * **Content:** `failed to parse input: Not found.`
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/blocks/1",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+## Headers Endpoint
+
+### GET Headers
+
+Returns data about a block headers given either a hash or height or an output commit.
+
+* **URL**
+
+  /v1/headers/hash
+  /v1/headers/height
+  /v1/headers/commit
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  **Required:**
+  `hash=[string]`
+  or
+  `height=[number]`
+  or
+  `commit=[string]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+    | Field                 | Type     | Description                                                                 |
+    |:----------------------|:---------|:----------------------------------------------------------------------------|
+    | header                | object   | The block header                                                            |
+    | - hash                | string   | Hash of the current block                                                   |
+    | - version             | number   | Version of the block                                                        |
+    | - height              | number   | Height of this block since the genesis block (height 0)                     |
+    | - previous            | string   | Hash of the block previous to this in the chain                             |
+    | - timestamp           | string   | RFC3339 timestamp at which the block was built                              |
+    | - output_root         | string   | Merklish root of all the commitments in the TxHashSet                       |
+    | - range_proof_root    | string   | Merklish root of all range proofs in the TxHashSet                          |
+    | - kernel_root         | string   | Merklish root of all transaction kernels in the TxHashSet                   |
+    | - nonce               | number   | Nonce increment used to mine this block                                     |
+    | - cuckoo_size         | number   | Size of the cuckoo graph                                                    |
+    | - cuckoo_solution     | []number | The Cuckoo solution for this block                                          |
+    | - total_difficulty    | number   | Total accumulated difficulty since genesis block                            |
+    | - total_kernel_offset | string   | Total kernel offset since genesis block                                     |
+
+* **Error Response:**
+
+  * **Code:** 404 or 500
+  * **Content:** `failed to parse input: Not found.`
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/headers/1",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+## Chain Endpoint
+
+### GET Chain
+
+Retrieves details about the state of the current fork tip.
+
+* **URL**
+
+  /v1/chain
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  None
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+    | Field              | Type     | Description                                                   |
+    |:-------------------|:---------|:--------------------------------------------------------------|
+    | height             | number   | Height of the tip (max height of the fork)                    |
+    | last_block_pushed  | string   | Last block pushed to the fork                                 |
+    | prev_block_to_last | string   | Block previous to last                                        |
+    | total_difficulty   | number   | Total difficulty accumulated on that fork since genesis block |
+
+* **Error Response:**
+
+  * **Code:** 404 or 500
+  * **Content:** `failed to parse input: Not found.`
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/chain",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### POST Chain Compact
+
+Trigger a compaction of the chain state to regain storage space.
+
+* **URL**
+
+  /v1/chain/compact
+
+* **Method:**
+
+  `POST`
+  
+* **URL Params**
+
+  None
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+
+* **Error Response:**
+
+  * **Code:** 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/chain/compact",
+      dataType: "json",
+      type : "POST",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### POST Chain Validate
+
+Trigger a validation of the chain state.
+
+* **URL**
+
+  /v1/chain/validate
+
+* **Method:**
+
+  `POST`
+  
+* **URL Params**
+
+  None
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+
+* **Error Response:**
+
+  * **Code:** 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/chain/validate",
+      dataType: "json",
+      type : "POST",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### GET Chain Outputs By IDs
+
+Retrieves details about specifics outputs. Supports retrieval of multiple outputs in a single request.
+
+* **URL**
+
+  /v1/chain/outputs/byids?id=x
+  /v1/chain/outputs/byids?id=x,y,z
+  /v1/chain/outputs/byids?id=x&id=y&id=z
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  **Required:**
+  `id=[string]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+    | Field                 | Type     | Description                                                                 |
+    |:----------------------|:---------|:----------------------------------------------------------------------------|
+    | outputs               | []object | Outputs                                                                     |
+    | - output_type         | string   | The type of output Coinbase|Transaction                                     |
+    | - commit              | string   | The homomorphic commitment representing the output's amount (as hex string) |
+    | - spent               | bool     | Whether the output has been spent                                           |
+    | - proof               | string   | Rangeproof (as hex string)                                                  |
+    | - proof_hash          | string   | Rangeproof hash (as hex string)                                             |
+    | - block_height        | number   | Block height at which the output is found                                   |
+    | - merkle_proof        | string   | Merkle proof                                                                |
+
+* **Error Response:**
+
+  * **Code:** 404 or 500
+  * **Content:** `[]`
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/chain/outputs/byids?id=0803516094a30830ed9fedff1c63251b51703ddffbb73f944d9e33e8fa5d17444f",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### GET Chain Outputs By Height
+
+Retrieves details about specifics outputs. Supports retrieval of multiple outputs in a single request.
+
+* **URL**
+
+  /v1/chain/outputs/byheight?start_height=x&end_height=y
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  **Required:**
+  `start_height=[number]`
+  `end_height=[number]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+    | Field                 | Type     | Description                                                                 |
+    |:----------------------|:---------|:----------------------------------------------------------------------------|
+    | header                | object   | The block header                                                            |
+    | - hash                | string   | Hash of the current block                                                   |
+    | - height              | number   | Height of this block since the genesis block (height 0)                     |
+    | - previous            | string   | Hash of the block previous to this in the chain                             |
+    | outputs               | []object | Outputs                                                                     |
+    | - output_type         | string   | The type of output Coinbase|Transaction                                     |
+    | - commit              | string   | The homomorphic commitment representing the output's amount (as hex string) |
+    | - spent               | bool     | Whether the output has been spent                                           |
+    | - proof               | string   | Rangeproof (as hex string)                                                  |
+    | - proof_hash          | string   | Rangeproof hash (as hex string)                                             |
+    | - block_height        | number   | Block height at which the output is found                                   |
+    | - merkle_proof        | string   | Merkle proof                                                                |
+
+* **Error Response:**
+
+  * **Code:** 404 or 500
+  * **Content:** `[]`
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/chain/outputs/byheight?start_height=101&end_height=200",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+## Status Endpoint
+
+### GET Status
+
+Returns various information about the node and the network
+
+* **URL**
+
+  /v1/status
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  None
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+    | Field              | Type     | Description                                                   |
+    |:-------------------|:---------|:--------------------------------------------------------------|
+    | protocol_version   | number   | The node protocol version                                     |
+    | user_agent         | number   | The node user agent                                           |
+    | connections        | number   | The current number of connections                             |
+    | tip                | object   | The state of the current fork tip                             |
+    | height             | number   | Height of the tip (max height of the fork)                    |
+    | last_block_pushed  | string   | Last block pushed to the fork                                 |
+    | prev_block_to_last | string   | Block previous to last                                        |
+    | total_difficulty   | number   | Total difficulty accumulated on that fork since genesis block |
+
+* **Error Response:**
+
+  * **Code:** 404 or 500
+  * **Content:** `failed to parse input: Not found.`
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/stats",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+## TxHashSet Endpoint
+
+### GET TxHashSet Roots
+
+Retrieve the roots of the TxHashSet
+
+* **URL**
+
+  /v1/txhashset/roots
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  None
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+    | Field                 | Type     | Description          |
+    |:----------------------|:---------|:---------------------|
+    | output_root_hash      | string   | Output root hash     |
+    | range_proof_root_hash | string   | Rangeproof root hash |
+    | kernel_root_hash      | string   | Kernel set root hash |
+
+* **Error Response:**
+
+  * **Code:** 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/txhashset/roots",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### GET TxHashSet Last Outputs
+
+Retrieves the last n outputs inserted into the tree.
+
+* **URL**
+
+/v1/txhashset/lastoutputs (gets last 10)
+/v1/txhashset/lastoutputs?n=x
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+  
+  **Required:**
+  `n=[number]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+  Array of
+
+    | Field               | Type     | Description         |
+    |:--------------------|:---------|:--------------------|
+    | hash                | string   | hash of the outputs |
+
+* **Error Response:**
+
+  * **Code:** 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/txhashset/lastoutputs?n=20",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### GET TxHashSet Last Range Proofs
+
+Retrieves the last n rangeproofs inserted in to the tree.
+
+* **URL**
+
+/v1/txhashset/lastrangeproofs (gets last 10)
+/v1/txhashset/lastrangeproofs?n=x
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  **Required:**
+  `n=[number]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+  Array of
+
+    | Field               | Type     | Description             |
+    |:--------------------|:---------|:------------------------|
+    | hash                | string   | hash of the rangeproofs |
+
+* **Error Response:**
+
+  * **Code:** 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "v1/txhashset/lastrangeproofs",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### GET TxHashSet Last Kernels
+
+Retrieves the last n kernels inserted in to the tree.
+
+* **URL**
+
+/v1/txhashset/lastkernels (gets last 10)
+/v1/txhashset/lastkernels?n=x
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  **Required:**
+  `n=[number]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+  Array of
+
+    | Field               | Type     | Description         |
+    |:--------------------|:---------|:--------------------|
+    | hash                | string   | hash of the kernels |
+
+* **Error Response:**
+
+  * **Code:** 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/txhashset/lastkernels?n=20",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### GET TxHashSet Outputs
+
+UTXO traversal. Retrieves last utxos since a start index until a max.
+
+* **URL**
+
+  /v1/txhashset/outputs?start_index=x&max=y
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  **Required:**
+  `start_index=[number]`
+  `max=[number]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+    | Field                 | Type     | Description                                                                 |
+    |:----------------------|:---------|:----------------------------------------------------------------------------|
+    | highest_index         | number   | The last available output index                                             |
+    | last_retrieved_index  | number   | The last insertion index retrieved                                          |
+    | outputs               | []object | Outputs                                                                     |
+    | - output_type         | string   | The type of output Coinbase|Transaction                                     |
+    | - commit              | string   | The homomorphic commitment representing the output's amount (as hex string) |
+    | - spent               | bool     | Whether the output has been spent                                           |
+    | - proof               | string   | Rangeproof (as hex string)                                                  |
+    | - proof_hash          | string   | Rangeproof hash (as hex string)                                             |
+    | - block_height        | number   | Block height at which the output is found                                   |
+    | - merkle_proof        | string   | Merkle proof                                                                |
+    | kernels               | []object | Transaction Kernels (a proof that a transaction sums to zero)               |
+    | - features            | string   | Rank of the user                                                            |
+    | - fee                 | number   | Hashrate of the user                                                        |
+    | - lock_height         | number   | Rank of the user                                                            |
+    | - excess              | string   | Hashrate of the user                                                        |
+    | - excess_sig          | string   | Rank of the user                                                            |
+
+* **Error Response:**
+
+  * **Code:** 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/txhashset/outputs?start_index=1&max=100",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### GET TxHashSet Merkle Proof
+
+Build a merkle proof for a given output id and return a dummy output with merkle proof for position filled out.
+
+* **URL**
+
+  /v1/txhashset/merkleproof?n=x
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  **Required:**
+  `n=[string]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+    | Field                 | Type     | Description                                                                 |
+    |:----------------------|:---------|:----------------------------------------------------------------------------|
+    | outputs               | []object | Outputs                                                                     |
+    | - output_type         | string   | The type of output Coinbase|Transaction                                     |
+    | - commit              | string   | The homomorphic commitment representing the output's amount (as hex string) |
+    | - spent               | bool     | Whether the output has been spent                                           |
+    | - proof               | string   | Rangeproof (as hex string)                                                  |
+    | - proof_hash          | string   | Rangeproof hash (as hex string)                                             |
+    | - block_height        | number   | Block height at which the output is found                                   |
+    | - merkle_proof        | string   | Merkle proof                                                                |
+
+* **Error Response:**
+
+  * **Code:** 404 or 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/txhashset/merkleproof?n=0803516094a30830ed9fedff1c63251b51703ddffbb73f944d9e33e8fa5d17444f",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+## Pool Endpoint
+
+### GET Pool
+
+Retrieves basic information about the transaction pool.
+
+* **URL**
+
+  /v1/pool
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  None
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+    | Field     | Type     | Description                               |
+    |:----------|:---------|:------------------------------------------|
+    | pool_size | number   | Number of transactions in the memory pool |
+
+* **Error Response:**
+
+  * **Code:** 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/pool",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### POST Pool Push
+
+Push new transaction to our local transaction pool. Add `?fluff` at the end of the URL to bypass Dandelion relay.
+
+* **URL**
+
+  /v1/pool/push
+
+* **Method:**
+
+  `POST`
+  
+* **URL Params**
+
+  None
+
+* **Data Params**
+
+  `file=[string]` (hex encoded transaction)
+
+* **Success Response:**
+
+  * **Code:** 200
+
+* **Error Response:**
+
+  * **Code:** 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/pool/push",
+      dataType: "json",
+      type : "POST",
+      data: {
+        file: tx
+      },
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+## Peers Endpoint
+
+### POST Peers Ban
+
+Ban a specific peer.
+
+* **URL**
+
+  /v1/peers/a.b.c.d:p/ban
+
+* **Method:**
+
+  `POST`
+  
+* **URL Params**
+
+  `a.b.c.d:p=[string]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+
+* **Error Response:**
+
+  * **Code:** 400
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/peers/192.168.1.1:13414/ban",
+      dataType: "json",
+      type : "POST",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### POST Peers Unban
+
+Unban a specific peer.
+
+* **URL**
+
+  /v1/a.b.c.d:p/unban
+
+* **Method:**
+
+  `POST`
+  
+* **URL Params**
+
+  `a.b.c.d:p=[string]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+
+* **Error Response:**
+
+  * **Code:** 400
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/192.168.1.1:13414/unban",
+      dataType: "json",
+      type : "POST",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### GET Peers All
+
+Retrieves all peers in db.
+
+* **URL**
+
+  /v1/peers/all
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  None
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+  Array of
+
+    | Field       | Type     | Description                                |
+    |:------------|:---------|:-------------------------------------------|
+    | addr        | string   | Network address of the peer                |
+    | capabilities| object   | What capabilities the peer advertises      |
+    | - bits      | number   | Representation of the capabilities in bits |
+    | user_agent  | string   | The peer user agent                        |
+    | flags       | string   | State the peer has been detected with.     |
+    | last_banned | number   | The time the peer was last banned          |
+    | ban_reason  | string   | The reason for the ban                     |
+
+* **Error Response:**
+
+  * **Code:** 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/peers/all",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### GET Peers Connected
+
+Retrieves all connected peers
+
+* **URL**
+
+  /v1/peers/connected
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  None
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+  Array of
+
+    | Field            | Type     | Description                                   |
+    |:-----------------|:---------|:----------------------------------------------|
+    | capabilities     | object   | What capabilities the peer advertises         |
+    | - bits           | number   | Representation of the capabilities in bits    |
+    | user_agent       | string   | The peer user agent                           |
+    | version          | number   | Software version of the peer                  |
+    | addr             | string   | Network address of the peer                   |
+    | total_difficulty | number   | Total of difficulty of the peer               |
+    | height           | number   | Height of the peer                            |
+    | direction        | string   | Direction of the connection (Inbound|Outbound)|
+
+* **Error Response:**
+
+  * **Code:** 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/peers/connected",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
+
+### GET Peers
+
+Retrieves information about a specific peer.
+
+* **URL**
+
+  /v1/peers/a.b.c.d
+
+* **Method:**
+
+  `GET`
+  
+* **URL Params**
+
+  `a.b.c.d=[string]`
+
+* **Data Params**
+
+  None
+
+* **Success Response:**
+
+  * **Code:** 200
+  * **Content:**
+
+    | Field       | Type     | Description                                |
+    |:------------|:---------|:-------------------------------------------|
+    | addr        | string   | Network address of the peer                |
+    | capabilities| object   | What capabilities the peer advertises      |
+    | - bits      | number   | Representation of the capabilities in bits |
+    | user_agent  | string   | The peer user agent                        |
+    | flags       | string   | State the peer has been detected with.     |
+    | last_banned | number   | The time the peer was last banned          |
+    | ban_reason  | string   | The reason for the ban                     |
+
+* **Error Response:**
+
+  * **Code:** 404 or 500
+
+* **Sample Call:**
+
+  ```javascript
+    $.ajax({
+      url: "/v1/peers/192.168.1.2",
+      dataType: "json",
+      type : "GET",
+      success : function(r) {
+        console.log(r);
+      }
+    });
+  ```
\ No newline at end of file
diff --git a/doc/api/wallet_foreign_api.md b/doc/api/wallet_foreign_api.md
new file mode 100644
index 000000000..e69de29bb
diff --git a/doc/api/wallet_owner_api.md b/doc/api/wallet_owner_api.md
new file mode 100644
index 000000000..e69de29bb
diff --git a/doc/table_of_contents.md b/doc/table_of_contents.md
index cf15a6dd5..2927e0d53 100644
--- a/doc/table_of_contents.md
+++ b/doc/table_of_contents.md
@@ -21,6 +21,7 @@
 
 ## Build and use
 
+- [api](api/api/md) - Explaining the different APIs in Grin and how to use them
 - [build](build.md) - Explaining how to build and run the Grin binaries
 - [release](release_instruction.md) - Instructions of making a release
 - [usage](usage.md) - Explaining how to use grin in Testnet3