Parameters

type

string

REQUIRED

Request type identifier. Set this value to 'twapHistory'

user

string

REQUIRED

The 42-character hexadecimal address of the user whose TWAP history to retrieve

Returns

array

array

Array of historical TWAP order records. The array is empty when the user has no TWAP history.

time

integer

Creation time of the history record as a Unix timestamp in seconds

state

object

Execution state of the TWAP order

coin

string

Asset symbol for the TWAP order

executedNtl

string

Notional value executed so far, returned as a decimal string

executedSz

string

Order size executed so far, returned as a decimal string

minutes

integer

Configured TWAP duration in minutes

randomize

boolean

Indicates whether execution timing is randomized

reduceOnly

boolean

Indicates whether the TWAP can only reduce an existing position

side

string

Order side: 'B' for bid or buy, and 'A' for ask or sell

stopPx

string | null

Price at which the order stops, or null when no stop price is configured

sz

string

Original TWAP order size, returned as a decimal string

timestamp

integer

TWAP start time as a Unix timestamp in milliseconds

trigger

object | null

Trigger condition for the TWAP, or null when no trigger is configured

px

string

Trigger price, returned as a decimal string

above

boolean

When true, activates above the trigger price; when false, activates below it

user

string

The 42-character hexadecimal address that placed the TWAP order

status

object

Current or final status of the TWAP order

status

string

Status value: 'finished', 'activated', 'terminated', 'waitingForTrigger', 'stopped', or 'error'

description

string

Error description. Present only when status is 'error'

twapId

integer

Optional unique identifier of the TWAP order

Request

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"type":"twapHistory","user":"0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00"}'
5

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"type":"twapHistory","user":"0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00"}'
5

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "type": "twapHistory",
6
  "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00"
7
});
8

9
var requestOptions = {
10
  method: 'POST',
11
  headers: myHeaders,
12
  body: raw,
13
  redirect: 'follow'
14
};
15

16
fetch("https://docs-demo.hype-mainnet.quiknode.pro/evm", requestOptions)
17
  .then(response => response.text())
18
  .then(result => console.log(result))
19
  .catch(error => console.log('error', error));
20

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "type": "twapHistory",
6
  "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00"
7
});
8

9
var requestOptions = {
10
  method: 'POST',
11
  headers: myHeaders,
12
  body: raw,
13
  redirect: 'follow'
14
};
15

16
fetch("https://docs-demo.hype-mainnet.quiknode.pro/evm", requestOptions)
17
  .then(response => response.text())
18
  .then(result => console.log(result))
19
  .catch(error => console.log('error', error));
20

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/evm"
5

6
payload = json.dumps({
7
  "type": "twapHistory",
8
  "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00"
9
})
10
headers = {
11
  'Content-Type': 'application/json'
12
}
13

14
response = requests.request("POST", url, headers=headers, data=payload)
15

16
print(response.text)
17

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/evm"
5

6
payload = json.dumps({
7
  "type": "twapHistory",
8
  "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00"
9
})
10
headers = {
11
  'Content-Type': 'application/json'
12
}
13

14
response = requests.request("POST", url, headers=headers, data=payload)
15

16
print(response.text)
17

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/evm")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "type": "twapHistory",
14
  "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00"
15
})
16

17
response = https.request(request)
18
puts response.read_body
19

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/evm")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "type": "twapHistory",
14
  "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00"
15
})
16

17
response = https.request(request)
18
puts response.read_body
19

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free