Prints token pairs rate history (or only filtrated by time)
All times are in RFC822. For example, "`7 Dec 2023 21:18:04`"
## Request Structure
`JSON object:`
```JSON
{
"method": "srv_xchange",
"subcommand": ["token_pair","rate","history"],
"arguments": {
"net": "network_name",
"token_from": "token_ticker",
"token_to": "token_ticker",
"time_from": "From time",
"time_to": "To time",
"limit": "null",
"offset": "null"
},
"id": "1"
}
```
`Parameters:`
**`net (network_name)`** - name of the Cellframe Network. The list of networks can be found in the `<Config_dir> \ etc \ network` folder or received using - [[Node Command - NET LIST]]
**`token_from`** - ticker of token is being sold
**`token_to`** - ticker of token is being bought
**`time_from`** - filtration by time since specified value `optional`
**`time_to`** - filtration by time until specified value `optional`
**`limit`** - number of elements being printed `optional`
**`offset`** - number of the element from which printing will be started `optional`
### Curl Example
`Request:`
```actionscript
curl --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '{
"method": "srv_xchange",
"subcommand": ["token_pair","rate","history"],
"arguments": {
"net": "riemann",
"token_from": "tKEL",
"token_to": "CRINGE"
},
"id": "1"
}'
```
`Response:`
```json
{
"type": 2,
"result": [
[
{
"limit": 1000
},
{
"hash": "0x68D7559147BF9D228A68FF53A3F2B4735377834ACF5DE6FC1095D48B1ECBF00D",
"ts_created": "Mon, 12 May 2025 07:38:00 +0000",
"proposed_coins": "5.0",
"proposed_datoshi": "5000000000000000000",
"ticker": "tKEL",
"buy_token": "CRINGE",
"rate": "2.0",
"net": "riemann",
"owner_addr": "o9z3wUTSTicckJuoz2KebPSeZuMAfFQiPobvhwmy9dzC2RefQmy7EH7a74qZFXZE3g8LFf284mLR152wGPHbAAifMk55f6haWGmPkrW6"
},
{
"hash": "0x16D7EACF319EF2BCD618A5B3420CED1A2255BE8FD90609CE4DB3B46353098ED1",
"ts_created": "Mon, 12 May 2025 09:47:23 +0000",
"returned_coins": "5.0",
"returned_datoshi": "5000000000000000000",
"ticker": "tKEL",
"order_hash": "0x68D7559147BF9D228A68FF53A3F2B4735377834ACF5DE6FC1095D48B1ECBF00D",
"owner_addr": "o9z3wUTSTicckJuoz2KebPSeZuMAfFQiPobvhwmy9dzC2RefQmy7EH7a74qZFXZE3g8LFf284mLR152wGPHbAAifMk55f6haWGmPkrW6"
}
],
{
"tx_count": 2,
"trading_val_from_coins": "0.0",
"trading_val_from_datoshi": "0",
"trading_val_to_coins": "0.0",
"trading_val_to_datoshi": "0"
}
],
"id": 1
}
```