> For the complete documentation index, see [llms.txt](https://docs-swft.en.swft.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-swft.en.swft.pro/trade-api/get-market-depth.md).

# Get Market Depth

**1. Request Url**

 `https://{host}/marketApi/depth`

**2. Request Param**

| Parameter name | Is it necessary | description                                                                       |
| -------------- | --------------- | --------------------------------------------------------------------------------- |
| channelId      | Y               | Channel number                                                                    |
| timestamp      | Y               | Millisecond timestamp（UTC+8）                                                      |
| sign           | Y               | See "[Signature Generation](/trade-api/generate-signature.md#generate-signature)" |
| tradePair      | Y               | Trade pair                                                                        |
| depth          | Y               | Deep polymerization, 1,2,3,4,5,6                                                  |

**3.Request Example**

```
 {
     "channelId":"swft-channel",
     "sign":"102027D292DD0707E0D899459D91C759858D7367D223CB239A8EC3A90C30B122",
     "timestamp":"1557653925555",
     "tradePair":"BTC/USDT",
     "depth":"1"
 }
```

**4.Response Data**

```
 {
    "data":{
        "buyOrders":[
            [
                "10395.67",
                "0.006137"
            ],
            [
                "10393.50",
                "4.741722"
            ]
        ],
        "sellOrders":[
            [
                "10392.33",
                "0.097679"
            ],
            [
                "10392.39",
                "1.593146"
            ]
        ],
        "latestPrice":"10392.33",
        "latestType":"buy"
    },
    "resCode":"800",
    "resMsg":"SUCCESS"
}
```

**5.Response Data Explanation**

| Description  | Is Array | Parameter name | Data type | Length | Is it necessary | Remark       |
| ------------ | -------- | -------------- | --------- | ------ | --------------- | ------------ |
| Buy orders   | Y        | buyOrders      | Array     | -      | Y               | eg: array    |
| Sell orders  | Y        | sellOrders     | Array     | -      | Y               | eg: array    |
| Latest price | N        | latestPrice    | String    | 20     | Y               | eg: 10392.33 |
| Latest type  | N        | latestType     | String    | 20     | Y               | eg: sell/buy |