Parameters

type

string

REQUIRED

Request type identifier specifying 'portfolio' as the info endpoint method to retrieve comprehensive account portfolio overview and position summaries

user

string

REQUIRED

Ethereum-compatible wallet address in 42-character hexadecimal format (0x...) of the account whose complete portfolio data you want to retrieve

Returns

period

string

Time period identifier for this historical snapshot. Possible values: 'day', 'week', 'month', 'allTime', 'perpDay', 'perpWeek', 'perpMonth', 'perpAllTime'. Use for organizing account history by timeframe.

accountValueHistory

array

Array of [timestamp, value] pairs representing account equity over time for this period. Value is in USDC and includes realized and unrealized PnL. Timestamps are Unix milliseconds.

timestamp

integer

Unix timestamp in milliseconds of this historical snapshot.

value

string

Account equity at this time in USDC. Includes deposits, withdrawals, realized and unrealized PnL. Returned as string for decimal precision.

pnlHistory

array

Array of [timestamp, pnl] pairs representing realized/unrealized PnL over time for this period. Positive values indicate profit, negative values indicate loss.

timestamp

integer

Unix timestamp in milliseconds of this PnL snapshot.

pnl

string

Profit or loss at this timestamp in USDC. Returned as string for decimal precision.

vlm

string

Total volume traded during this period in USDC. Returned as string to preserve decimal precision.

Request

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

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

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

4
var raw = JSON.stringify({
5
  "type": "portfolio",
6
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
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": "portfolio",
6
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
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": "portfolio",
8
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
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": "portfolio",
8
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
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": "portfolio",
14
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
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": "portfolio",
14
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
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