Get Account Stats

Get the authenticated account’s 7-day trading stats (taker volume, maker volume, account maker share, and entity maker share when applicable). Stats are cached by UTC day and may be stale by up to 24 hours.

GET /v1/account/stats

Get Account Stats

cURL

curl --request GET \
  --url https://api.perpetuals.polymarket.com/v1/account/stats \
  --header 'POLYMARKET-PROXY: <api-key>' \
  --header 'POLYMARKET-SECRET: <api-key>'

import requests

url = "https://api.perpetuals.polymarket.com/v1/account/stats"

headers = {
    "POLYMARKET-PROXY": "<api-key>",
    "POLYMARKET-SECRET": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'POLYMARKET-PROXY': '<api-key>', 'POLYMARKET-SECRET': '<api-key>'}
};

fetch('https://api.perpetuals.polymarket.com/v1/account/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.perpetuals.polymarket.com/v1/account/stats",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "POLYMARKET-PROXY: <api-key>",
    "POLYMARKET-SECRET: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.perpetuals.polymarket.com/v1/account/stats"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("POLYMARKET-PROXY", "<api-key>")
	req.Header.Add("POLYMARKET-SECRET", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.perpetuals.polymarket.com/v1/account/stats")
  .header("POLYMARKET-PROXY", "<api-key>")
  .header("POLYMARKET-SECRET", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.perpetuals.polymarket.com/v1/account/stats")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["POLYMARKET-PROXY"] = '<api-key>'
request["POLYMARKET-SECRET"] = '<api-key>'

response = http.request(request)
puts response.read_body

200

{
  "volume_7d": "5000000",
  "taker_volume_7d": "3500000",
  "maker_volume_7d": "1500000",
  "account_maker_share_7d": "0.35",
  "entity_maker_share_7d": "0.35",
  "entity_id": 42,
  "entity_name": "desk"
}

{
  "status": "err",
  "error": "insufficient_margin"
}

{
  "status": "err",
  "error": "insufficient_margin"
}

{
  "status": "err",
  "error": "insufficient_margin"
}

Request Weight: 2

Authorizations

POLYMARKET-PROXY · string · header · required

Proxy address

POLYMARKET-SECRET · string · header · required

Correponding proxy secret

Response

200

application/json

Account stats response.

volume_7d · string · required

Rolling 7-day perpetual trading volume in USD

Example:

"5000000"

taker_volume_7d · string · required

Rolling 7-day perpetual taker volume in USD

Example:

"3500000"

maker_volume_7d · string · required

Rolling 7-day perpetual maker volume in USD

Example:

"1500000"

account_maker_share_7d · string · required

Rolling 7-day account maker volume divided by total exchange volume

Example:

"0.35"

entity_maker_share_7d · string

Rolling 7-day entity maker volume divided by total exchange volume

Example:

"0.35"

entity_id · integer

Liquidity rewards entity ID

Example:

42

entity_name · string

Liquidity rewards entity name

Example:

"desk"