1
0
mirror of https://github.com/oceanprotocol/docs.git synced 2024-11-26 19:49:26 +01:00
docs/developers/subgraph/get-veocean-stats.md
2023-06-05 15:51:31 +00:00

19 KiB

description
Discover the World of veOCEAN: Retrieving a Stats

Get veOCEAN stats

If you are already familiarized with veOCEAN, you're off to a great start. However, if you need a refresher, we recommend visiting the veOCEAN page for a quick overview 🔍

On this page, you'll find a few examples to fetch the stats of veOCEANS from the Ocean Subgraph. These examples serve as a valuable starting point to help you retrieve essential information about veOCEAN. However, if you're eager to delve deeper into the topic, we invite you to visit our GitHub repository. There, you'll discover a wealth of additional examples, which provide comprehensive insights. Feel free to explore and expand your knowledge! 📚

{% hint style="info" %} The veOcean is deployed on the Ethereum mainnet, along with two test networks, namely Mumbai and Goerli. The statistical data available is specifically limited to these networks. {% endhint %}

Get the total amount of locked Ocean tokens

{% tabs %} {% tab title="JavaScript" %} You can utilize the following JavaScript code snippet to execute the query and retrieve the total number of locked Ocean tokens:

var axios = require('axios');

const query = `query{
      globalStatistics{
        totalOceanLocked
      }
    }`

var config = {
  method: 'post',
  url: `https://v4.subgraph.mainnet.oceanprotocol.com/subgraphs/name/oceanprotocol/ocean-subgraph`,
  headers: { "Content-Type": "application/json" },
  data: JSON.stringify({ "query": query })
};

axios(config)
  .then(function (response) {
    console.log(response.data.data.globalStatistics)
  })
  .catch(function (error) {
    console.log(error);
  });

{% endtab %}

{% tab title="Python" %} You can employ the following Python script to execute the query and retrieve the total amount of locked Ocean tokens from the subgraph:

Create script

{% code title="get_ocean_locked.py" %}

import requests
import json

query = """
{
  query {
      globalStatistics{
        totalOceanLocked
      }
    }
}"""

base_url = "https://v4.subgraph.mainnet.oceanprotocol.com"
route = "/subgraphs/name/oceanprotocol/ocean-subgraph"

url = base_url + route

headers = {"Content-Type": "application/json"}
payload = json.dumps({"query": query})
response = requests.request("POST", url, headers=headers, data=payload)
result = json.loads(response.text)

print(json.dumps(result, indent=4, sort_keys=True))

{% endcode %}

Execute script

python get_ocean_locked.py

{% endtab %}

{% tab title="Query" %} To fetch the total amount of Ocean locked in the Ocean Subgraph GraphiQL interface, you can use the following query:

query {
  globalStatistics {
    totalOceanLocked
  }
}

{% endtab %} {% endtabs %}

Sample response
{
  "data": {
    "globalStatistics": [
      {
        "totalOceanLocked": "37649265.935690381628861228"
      }
    ]
  }
}

Get the veOCEAN holders list

{% tabs %} {% tab title="JavaScript" %} You can utilize the following JavaScript code snippet to execute the query and fetch the list of veOCEAN holders.

var axios = require('axios');

const query = `query {
  veOCEANs {    
    id,
    lockedAmount
    unlockTime
  }
}`

var config = {
  method: 'post',
  url: `https://v4.subgraph.mainnet.oceanprotocol.com/subgraphs/name/oceanprotocol/ocean-subgraph`,
  headers: { "Content-Type": "application/json" },
  data: JSON.stringify({ "query": query })
};

axios(config)
  .then(function (response) {
    for (let veHolder of response.data.data.veOCEANs) {
        console.log(veHolder)
    }
  })
  .catch(function (error) {
    console.log(error);
  });

{% endtab %}

{% tab title="Python" %} You can employ the following Python script to execute the query and fetch the list of veOCEAN holders from the subgraph.

{% code title="get_veOcean_holders.py" %}

import requests
import json

query = """
{
  query {
    veOCEANs {    
      id,
      lockedAmount
      unlockTime
    }
  }
}"""

base_url = "https://v4.subgraph.mainnet.oceanprotocol.com"
route = "/subgraphs/name/oceanprotocol/ocean-subgraph"

url = base_url + route

headers = {"Content-Type": "application/json"}
payload = json.dumps({"query": query})
response = requests.request("POST", url, headers=headers, data=payload)
result = json.loads(response.text)

print(json.dumps(result, indent=4, sort_keys=True))

{% endcode %}

Execute script

python get_veOcean_holders.py

{% endtab %}

{% tab title="Query" %} To fetch the list of veOCEAN holders in the Ocean Subgraph GraphiQL interface, you can use the following query:

query {
  veOCEANs {    
    id,
    lockedAmount
    unlockTime
  }
}

{% endtab %} {% endtabs %}

Sample response
{
  "data": {
    "veOCEANs": [
      {
        "id": "0x000afce0e19523ca2566b142bd12968fe1e44fe8",
        "lockedAmount": "1011",
        "unlockTime": "1727913600"
      },
      {
        "id": "0x001b71fad769b3cd47fd4c9849c704fdfabf6096",
        "lockedAmount": "8980",
        "unlockTime": "1790208000"
      },
      {
        "id": "0x002570980aa53893c6981765698b6ebab8ae7ea1",
        "lockedAmount": "126140",
        "unlockTime": "1790208000"
      },
      {
        "id": "0x006d0f31a00e1f9c017ab039e9d0ba699433a28c",
        "lockedAmount": "73724",
        "unlockTime": "1804118400"
      },
      {
        "id": "0x006d559fc29090589d02fb71d4142aa58b030013",
        "lockedAmount": "100",
        "unlockTime": "1793232000"
      },
      {
        "id": "0x008ed443f31a4b3aee02fbfe61c7572ddaf3a679",
        "lockedAmount": "1100",
        "unlockTime": "1795651200"
      },
      {
        "id": "0x009ec7d76febecabd5c73cb13f6d0fb83e45d450",
        "lockedAmount": "11200",
        "unlockTime": "1790812800"
      },
      {
        "id": "0x01d5595949fdbe521fbc39eaf09192dffb3bfc17",
        "lockedAmount": "28576",
        "unlockTime": "1675900800"
      },
      {
        "id": "0x02535d7bab47a83d33623c9a4ca854a1b1192121",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x02a6ab92964309e0d8a739e0252b3acfd3a58972",
        "lockedAmount": "1178",
        "unlockTime": "1712188800"
      },
      {
        "id": "0x02aa319b5ce28294b7207bdce3bbcf4bf514c05b",
        "lockedAmount": "300",
        "unlockTime": "1736985600"
      },
      {
        "id": "0x02ae6dfaffc2c1f410fcad1f36885f6cc8b677d5",
        "lockedAmount": "1009",
        "unlockTime": "1730937600"
      },
      {
        "id": "0x034e1f7a66b582b68e511b325ed0ccb71bb4bc12",
        "lockedAmount": "15919",
        "unlockTime": "1727913600"
      },
      {
        "id": "0x035a209abf018e4f94173fdeabe5abe69f1efbed",
        "lockedAmount": "1907",
        "unlockTime": "1714003200"
      },
      {
        "id": "0x03d4682823c33995184a6a85a97f4ca1715c9d5c",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x04aa87fa73238b563417d17ca7e57fd91ccd521e",
        "lockedAmount": "9435",
        "unlockTime": "1801699200"
      },
      {
        "id": "0x04c697561092c9cc56be6ff5b8e2789b0ca5837c",
        "lockedAmount": "226",
        "unlockTime": "1681948800"
      },
      {
        "id": "0x051f12380b842104391a0f9c55b32f6636cc7a0f",
        "lockedAmount": "24900",
        "unlockTime": "1685577600"
      },
      {
        "id": "0x054efb6d55466ba2ffb4133f39ae67985a314bed",
        "lockedAmount": "33083",
        "unlockTime": "1697068800"
      },
      {
        "id": "0x05a79e69c0dcb9335cbfa5b579635cbbd60f70ba",
        "lockedAmount": "15837",
        "unlockTime": "1728518400"
      },
      {
        "id": "0x05b2716d750f50c4fcd2110c5bff3f74bf0910e6",
        "lockedAmount": "744",
        "unlockTime": "1796256000"
      },
      {
        "id": "0x05c01104bd6c4c099fe4d13b0faf0a8c94f11082",
        "lockedAmount": "106026",
        "unlockTime": "1723680000"
      },
      {
        "id": "0x06a2006ca85813e652506b865e590f44eae3928a",
        "lockedAmount": "3100",
        "unlockTime": "1727308800"
      },
      {
        "id": "0x0705adac1869aa2648ddcf00da24b0ab6b76ede1",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x07dee7fb11086d543ed943bf075ad6ac2007aada",
        "lockedAmount": "34",
        "unlockTime": "1665014400"
      },
      {
        "id": "0x0848db7cb495e7b9ada1d4dc972b9a526d014d84",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x0861fcabe37a5ce396a8d85cd816e0cc6b4633ff",
        "lockedAmount": "500",
        "unlockTime": "1738800000"
      },
      {
        "id": "0x08c26d09393dc0adc7349c0c8d1bdae63555c312",
        "lockedAmount": "10036",
        "unlockTime": "1686787200"
      },
      {
        "id": "0x0a8162d91d6bf4530950e539068c75f7ddf972bc",
        "lockedAmount": "534",
        "unlockTime": "1791417600"
      },
      {
        "id": "0x0abe9b7740686cbf24b9f206e7d4e8ec25519476",
        "lockedAmount": "230",
        "unlockTime": "1690416000"
      },
      {
        "id": "0x0aef715335d0a19b870ca20fb540e16a6e606fbd",
        "lockedAmount": "210",
        "unlockTime": "1696464000"
      },
      {
        "id": "0x0b5665d637f45d6fff6c4afd4ea4191904ef38bb",
        "lockedAmount": "10000",
        "unlockTime": "1710979200"
      },
      {
        "id": "0x0bc1e0d21e3806056eeca20b69dd3f33bb49d0c7",
        "lockedAmount": "690",
        "unlockTime": "1738195200"
      },
      {
        "id": "0x0bc9cd548cc04bfcf8ef2fca50c13b9b4f62f6d4",
        "lockedAmount": "1250",
        "unlockTime": "1796256000"
      },
      {
        "id": "0x0be1b7f1a2eacde1cf5b48a4a1034c70dac06a70",
        "lockedAmount": "19982",
        "unlockTime": "1800489600"
      },
      {
        "id": "0x0c16b6d59a9d242f9cf6ca1999e372dd89a098a2",
        "lockedAmount": "1000",
        "unlockTime": "1723075200"
      },
      {
        "id": "0x0c21d79f460f7cacf3fd35172151bdbc5d61d9c1",
        "lockedAmount": "10",
        "unlockTime": "1676505600"
      },
      {
        "id": "0x0c4f299cce0e56004a6e3a30f43146a205bd2b9d",
        "lockedAmount": "250",
        "unlockTime": "1690416000"
      },
      {
        "id": "0x0c59aeeb4f82bbb7e38958900df5bf499c3e9e4f",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x0c6415489a8cc61ca7d32a29f7cdc1e980af16f1",
        "lockedAmount": "3788",
        "unlockTime": "1725494400"
      },
      {
        "id": "0x0ca0c241a45a9e8abad30a632df1a9a09a4eb692",
        "lockedAmount": "24987",
        "unlockTime": "1729123200"
      },
      {
        "id": "0x0cf776d57e0223f47ed3a101927bb78d41ad8a13",
        "lockedAmount": "16967",
        "unlockTime": "1790208000"
      },
      {
        "id": "0x0d04e73d950ff53e586da588c43bb3ac5ae53872",
        "lockedAmount": "19517",
        "unlockTime": "1703721600"
      },
      {
        "id": "0x0daefc5251f8f7f5a5dc987e8a6c96d9deb84559",
        "lockedAmount": "3000",
        "unlockTime": "1727308800"
      },
      {
        "id": "0x0e0bab764f38d63abf08680a50b33718c98b90e6",
        "lockedAmount": "13782",
        "unlockTime": "1797465600"
      },
      {
        "id": "0x0ed8063fcc5b44f664333b59a12d187de6551088",
        "lockedAmount": "265",
        "unlockTime": "1804118400"
      },
      {
        "id": "0x0ed8486119b992258a3754decaa36bf8bed543e8",
        "lockedAmount": "25881",
        "unlockTime": "1697068800"
      },
      {
        "id": "0x0efbdc4e858cbb269545d48f7b30ab260a3e5d10",
        "lockedAmount": "3294",
        "unlockTime": "1685577600"
      },
      {
        "id": "0x0f1107f97af6ae6eb37a9d35060aaa21cdaa109f",
        "lockedAmount": "15000",
        "unlockTime": "1790812800"
      },
      {
        "id": "0x0f84452c0dcda0c9980a0a802eb8b8dbaaf52c54",
        "lockedAmount": "25",
        "unlockTime": "1687392000"
      },
      {
        "id": "0x1019b7e639234c589c34385955adfbe0af8d8453",
        "lockedAmount": "2121",
        "unlockTime": "1706140800"
      },
      {
        "id": "0x104e9bce2d1a6fb449c14272f0157422a00adaa5",
        "lockedAmount": "7300",
        "unlockTime": "1744243200"
      },
      {
        "id": "0x111849a4943891b071f7cdb1babebcb74415204a",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x11300251b903ba70f51262f3e49aa7c22f81e1b2",
        "lockedAmount": "1504",
        "unlockTime": "1794441600"
      },
      {
        "id": "0x119b6e8c6b258b2b93443e949ef5066a85d75e44",
        "lockedAmount": "30000",
        "unlockTime": "1680134400"
      },
      {
        "id": "0x11e43d79e4193dfc1247697cb0ae15b17d27fc5b",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x1215fed867ad6eb5f078fc8b477a1a32eb59d75d",
        "lockedAmount": "18752",
        "unlockTime": "1730332800"
      },
      {
        "id": "0x126bc064dbd1d0205fc608c3178a60c9706b482c",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x1280cfea89a214b490c202fa22688813df8d8c04",
        "lockedAmount": "26000",
        "unlockTime": "1727913600"
      },
      {
        "id": "0x13203b4fef73f05b3db709c41c96179b37bf01eb",
        "lockedAmount": "293",
        "unlockTime": "1738195200"
      },
      {
        "id": "0x1479a4884dee82dc8471e0006102f9d400445332",
        "lockedAmount": "13009",
        "unlockTime": "1698883200"
      },
      {
        "id": "0x149756907221491eca8c5816a6b5d6b60fcd7d60",
        "lockedAmount": "4980",
        "unlockTime": "1684972800"
      },
      {
        "id": "0x153785d85dffe5b92083e30003aa58f18344d032",
        "lockedAmount": "50",
        "unlockTime": "1802304000"
      },
      {
        "id": "0x15558eb2aeb93ed561515a47441bf49250933ba9",
        "lockedAmount": "500000",
        "unlockTime": "1804118400"
      },
      {
        "id": "0x15a919e499d88a71e94d34ab76986799f69b4ff2",
        "lockedAmount": "4940",
        "unlockTime": "1733961600"
      },
      {
        "id": "0x15abf18f424cd2755e9d680eeeaa02bc00c1f00e",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x15f311af257d6e8520ebf29eae5ba76c4dd45c6a",
        "lockedAmount": "1420",
        "unlockTime": "1796860800"
      },
      {
        "id": "0x1609665376e39e9d9cdfdc75e44f80bb899e9d21",
        "lockedAmount": "8016",
        "unlockTime": "1699488000"
      },
      {
        "id": "0x1694ab8e597e90fcb4cd637bafa3e553fc1d0083",
        "lockedAmount": "364",
        "unlockTime": "1734566400"
      },
      {
        "id": "0x175437b00da09f18d89571b95a41a15aa8415eba",
        "lockedAmount": "88050",
        "unlockTime": "1798675200"
      },
      {
        "id": "0x1758bc68a87abfede6a213666d15c028f2708b2b",
        "lockedAmount": "1494",
        "unlockTime": "1731542400"
      },
      {
        "id": "0x1843c3d1dd3e2564fada8ea50bb73819c6b53047",
        "lockedAmount": "3354",
        "unlockTime": "1793836800"
      },
      {
        "id": "0x184f19323defce76af86bb5a63aa976cd9f256d7",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x1891c8d948bc041b5e7c1a35185cc593a33b4a6c",
        "lockedAmount": "7436",
        "unlockTime": "1790208000"
      },
      {
        "id": "0x1a0d80e1bd429127bc9a4acee880426b818764ee",
        "lockedAmount": "420",
        "unlockTime": "1807747200"
      },
      {
        "id": "0x1a2409444f2f349c2e539eb013eed985b9d54e2f",
        "lockedAmount": "500",
        "unlockTime": "1687996800"
      },
      {
        "id": "0x1a9a6198c28d4dd5b9ab58e84677520ec741cb29",
        "lockedAmount": "2565",
        "unlockTime": "1683158400"
      },
      {
        "id": "0x1ab21891e9230e4a8c3e09d88e3c0b48d54f1a86",
        "lockedAmount": "980",
        "unlockTime": "1734566400"
      },
      {
        "id": "0x1bafc574581ea4b938dcfe0d0d93778303cb3fb7",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x1c175ce4f8f3e8a16df7165f15057a82a88c025c",
        "lockedAmount": "953",
        "unlockTime": "1692230400"
      },
      {
        "id": "0x1c7b100cc8a2966d35ac6cc0ccaf4d5cba463b94",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x1cd1b778cdc329292d196e490b65b7950bee1c97",
        "lockedAmount": "301",
        "unlockTime": "1700092800"
      },
      {
        "id": "0x1d11c308464f09228f7c81daa253ff9f415ea4f7",
        "lockedAmount": "21908",
        "unlockTime": "1697068800"
      },
      {
        "id": "0x1d3c2dc18ca3da0406cfb3634faab589c769215b",
        "lockedAmount": "625",
        "unlockTime": "1689811200"
      },
      {
        "id": "0x1ddb98275a09552b5be11e8e3118684ed6a809fc",
        "lockedAmount": "9209",
        "unlockTime": "1725494400"
      },
      {
        "id": "0x1e180d121eff6cd1b376af9318d4128093c46032",
        "lockedAmount": "0",
        "unlockTime": "0"
      },
      {
        "id": "0x1e2394b6b88f9329127d98347f6e696e4af33e13",
        "lockedAmount": "494",
        "unlockTime": "1680134400"
      },
      {
        "id": "0x1e38e305126bfe9b6329f5fdce28d72fdf9d5647",
        "lockedAmount": "183844",
        "unlockTime": "1801699200"
      },
      {
        "id": "0x1f130be1f04e159ef98c54f677b9b980b012417b",
        "lockedAmount": "10663",
        "unlockTime": "1745452800"
      },
      {
        "id": "0x1f3bcd409b2b2d88259aca77115e858ea3c65e9c",
        "lockedAmount": "2000",
        "unlockTime": "1732147200"
      },
      {
        "id": "0x1fac06467b7d9c3a9361f42ab7bd09e6a5719ec7",
        "lockedAmount": "81285",
        "unlockTime": "1802908800"
      },
      {
        "id": "0x1fba4f4446859ab451cb7f3b8fbce9bcdc97fdb9",
        "lockedAmount": "560",
        "unlockTime": "1689206400"
      },
      {
        "id": "0x200fa3e7e3fbfeb15b76e53f2810faec71a5336d",
        "lockedAmount": "2375",
        "unlockTime": "1805932800"
      },
      {
        "id": "0x2017ade0a289de891ca7e733513b264cfec2c8ce",
        "lockedAmount": "9119",
        "unlockTime": "1703721600"
      },
      {
        "id": "0x204909d955b3e94318cf5fb44883a6e0bad750d8",
        "lockedAmount": "21927",
        "unlockTime": "1804723200"
      },
      {
        "id": "0x207372a1df51a428d1b7e8aa2c81f0225d0a94b3",
        "lockedAmount": "2980",
        "unlockTime": "1788393600"
      },
      {
        "id": "0x20af0e0257312368ba0114e4c85389e158a07055",
        "lockedAmount": "159",
        "unlockTime": "1801699200"
      },
      {
        "id": "0x20d6ad3a7e0b402320fdb57bc5aae2d67dc9bad7",
        "lockedAmount": "1965",
        "unlockTime": "1744243200"
      },
      {
        "id": "0x214844a0f2b3da63c190e82f3b175a299a8362b4",
        "lockedAmount": "2000",
        "unlockTime": "1743638400"
      },
      {
        "id": "0x2196b9fe1117df9324108d82dffc849492c23c14",
        "lockedAmount": "10000",
        "unlockTime": "1793232000"
      }
    ]
  }