2020-03-28 14:53:20 +03:00
# Node API v1 Documentation
2018-10-04 16:35:39 +03:00
## 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 )
2019-03-11 06:18:21 +03:00
1. [GET Chain Validate ](#get-chain-validate )
2019-09-26 18:44:44 +03:00
1. [GET Chain Kernel by Commitment ](#get-chain-kernel-by-commitment )
2018-10-04 16:35:39 +03:00
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.
2019-09-03 17:52:33 +03:00
Optionally, Merkle proofs can be excluded from the results by adding `?no_merkle_proof` , rangeproofs can be included by adding `?include_proof` or results can be returned as "compact blocks" by adding `?compact` .
2018-10-04 16:35:39 +03:00
* **URL**
2018-10-17 17:51:50 +03:00
* /v1/blocks/hash
* /v1/blocks/height
* /v1/blocks/commit
2018-10-04 16:35:39 +03:00
* **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 |
2018-10-17 17:51:50 +03:00
| - prev_root | string | Root hash of the header MMR at the previous header |
2018-10-04 16:35:39 +03:00
| - 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 |
2018-10-16 02:14:23 +03:00
| - edge_bits | number | Size of the cuckoo graph (2_log of number of edges) |
2018-10-04 16:35:39 +03:00
| - cuckoo_solution | []number | The Cuckoo solution for this block |
| - total_difficulty | number | Total accumulated difficulty since genesis block |
2018-10-19 22:39:54 +03:00
| - secondary_scaling | number | Variable difficulty scaling factor for secondary proof of work |
2018-10-04 16:35:39 +03:00
| - 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) |
2018-10-04 21:55:03 +03:00
| - features | object | Options for a kernel's structure or use |
| - bits | number | Representation of the features in bits |
| - fee | number | Fee originally included in the transaction this proof is for |
| - lock_height | number | The max lock_height of all inputs to this transaction |
| - excess | []number | Remainder of the sum of all transaction commitments |
| - excess_sig | []number | The signature proving the excess is a valid public key (signs the tx fee) |
2018-10-04 16:35:39 +03:00
* **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**
2018-10-17 17:51:50 +03:00
* /v1/headers/hash
* /v1/headers/height
* /v1/headers/commit
2018-10-04 16:35:39 +03:00
* **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 |
2018-10-17 17:51:50 +03:00
| - prev_root | string | Root hash of the header MMR at the previous header |
2018-10-04 16:35:39 +03:00
| - 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 |
2018-10-16 02:14:23 +03:00
| - edge_bits | number | Size of the cuckoo graph (2_log of number of edges) |
2018-10-04 16:35:39 +03:00
| - 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);
}
});
```
2019-03-11 06:18:21 +03:00
### GET Chain Validate
2018-10-04 16:35:39 +03:00
Trigger a validation of the chain state.
* **URL**
/v1/chain/validate
* **Method:**
2019-03-11 06:18:21 +03:00
`GET`
2018-10-04 16:35:39 +03:00
* **URL Params**
None
* **Data Params**
None
* **Success Response:**
* **Code:** 200
* **Error Response:**
* **Code:** 500
* **Sample Call:**
```javascript
$.ajax({
url: "/v1/chain/validate",
dataType: "json",
2019-03-11 06:18:21 +03:00
type : "GET",
2018-10-04 16:35:39 +03:00
success : function(r) {
console.log(r);
}
});
```
2019-09-26 18:44:44 +03:00
### GET Chain Kernel By Commitment
Look up an on-chain kernel and the height of the block it is included in. By default `min_height` is 0.
* **URL**
* /v1/chain/kernels/xxx?min_height=yyy& max_height=zzz
* **Method:**
`GET`
* **URL Params**
**Required:**
`commitment=[string]`
**Optional:**
`min_height=[number]`
`max_height=[number]`
* **Data Params**
None
* **Success Response:**
* **Code:** 200
* **Content:**
| Field | Type | Description |
|:-------------|:-------|:--------------------------------------------------------------------------------|
| tx_kernel | object | Transaction Kernel |
| - features | object | The type of output Coinbase|Transaction |
| - features | object | The kernel features. Can either be `Plain` , `Coinbase` or `HeightLocked` . |
| - excess | string | The kernel excess also called commitment |
| - excess_sig | string | The excess signature |
| height | string | THe height of the block this kernel is included in |
| mmr_height | string | Position in the MMR |
* **Error Response:**
* **Code:** 404 or 500
* **Content:** `[]`
* **Sample Call:**
```javascript
$.ajax({
url: "/v1/chain/kernels/0939fe3dc6a35350da91c6288138b7a257e0c0322eae30bda3938229d649e2e642?max_height=324300",
dataType: "json",
type : "GET",
success : function(r) {
console.log(r);
}
});
```
2018-10-04 16:35:39 +03:00
### GET Chain Outputs By IDs
Retrieves details about specifics outputs. Supports retrieval of multiple outputs in a single request.
* **URL**
2018-10-17 17:51:50 +03:00
* /v1/chain/outputs/byids?id=x
* /v1/chain/outputs/byids?id=x,y,z
* /v1/chain/outputs/byids?id=x& id=y& id=z
2018-10-04 16:35:39 +03:00
* **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 |
2019-09-26 18:44:44 +03:00
| sync_status | string | The current sync status |
| sync_info | object | Additional sync information. This field is optional. |
2018-10-04 16:35:39 +03:00
* **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**
2018-10-17 17:51:50 +03:00
* /v1/txhashset/lastoutputs (gets last 10)
* /v1/txhashset/lastoutputs?n=x
2018-10-04 16:35:39 +03:00
* **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**
2018-10-17 17:51:50 +03:00
* /v1/txhashset/lastrangeproofs (gets last 10)
* /v1/txhashset/lastrangeproofs?n=x
2018-10-04 16:35:39 +03:00
* **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**
2018-10-17 17:51:50 +03:00
* /v1/txhashset/lastkernels (gets last 10)
* /v1/txhashset/lastkernels?n=x
2018-10-04 16:35:39 +03:00
* **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) |
2018-10-04 21:55:03 +03:00
| - features | object | Options for a kernel's structure or use |
| - bits | number | Representation of the features in bits |
| - fee | number | Fee originally included in the transaction this proof is for |
| - lock_height | number | The max lock_height of all inputs to this transaction |
| - excess | []number | Remainder of the sum of all transaction commitments |
| - excess_sig | []number | The signature proving the excess is a valid public key (signs the tx fee) |
2018-10-04 16:35:39 +03:00
* **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**
2018-10-30 17:49:45 +03:00
/v1/txhashset/merkleproof?id=x
2018-10-04 16:35:39 +03:00
* **Method:**
`GET`
* **URL Params**
**Required:**
2018-10-30 17:49:45 +03:00
`id=[string]`
2018-10-04 16:35:39 +03:00
* **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({
2018-10-30 17:49:45 +03:00
url: "/v1/txhashset/merkleproof?id=0803516094a30830ed9fedff1c63251b51703ddffbb73f944d9e33e8fa5d17444f",
2018-10-04 16:35:39 +03:00
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);
}
});
2018-10-16 02:14:23 +03:00
```
