Docs
⌘ K

3 minutos

Como Consultar Dados de Blockchain do Polymarket com Subgraphs no The Graph

Solicite os dados na chain do Polymarket com a GraphQL, via subgraphs na The Graph Network. Subgraphs são APIs descentralizadas energizadas pelo The Graph, um protocolo para indexação e consulta de dados de blockchains.

Subgraph do Polymarket no Graph Explorer

Dá para ver um playground interativo de queries na página do subgraph do Polymarket no The Graph Explorer, onde pode-se testar qualquer query.

Playground da Polymarket

Como Usar o Editor Visual de Queries

O editor visual de queries permite-lhe testar exemplos de query do seu subgraph.

Você pode usar o GraphiQL Explorer para compor os seus queries da GraphQL clicando nos campos desejados.

Exemplo de Query: 5 maiores pagamentos do Polymarket

{  redemptions(orderBy: payout, orderDirection: desc, first: 5) {    payout    redeemer    id    timestamp  }}

Exemplo de retorno

{  "data": {    "redemptions": [      {        "id": "0x8fbb68b7c0cbe9aca6024d063a843a23d046b5522270fd25c6a81c511cf517d1_0x3b",        "payout": "6274509531681",        "redeemer": "0xfffe4013adfe325c6e02d36dc66e091f5476f52c",        "timestamp": "1722929672"      },      {        "id": "0x2b2826448fcacde7931828cfcd3cc4aaeac8080fdff1e91363f0589c9b503eca_0x7",        "payout": "2246253575996",        "redeemer": "0xfffe4013adfe325c6e02d36dc66e091f5476f52c",        "timestamp": "1726701528"      },      {        "id": "0x983b71c64b5075fc1179f4e03849af9c727be60de71c9e86e37ad0b3e43f9db9_0x26",        "payout": "2135448291991",        "redeemer": "0x5a181dcf3eb53a09fb32b20a5a9312fb8d26f689",        "timestamp": "1704932625"      },      {        "id": "0x2b2826448fcacde7931828cfcd3cc4aaeac8080fdff1e91363f0589c9b503eca_0xa",        "payout": "1917395333835",        "redeemer": "0xfffe4013adfe325c6e02d36dc66e091f5476f52c",        "timestamp": "1726701528"      },      {        "id": "0xfe82e117201f5169abc822281ccf0469e6b3740fcb4e799d1b599f83b8f11656_0x30",        "payout": "1862505580000",        "redeemer": "0xfffe4013adfe325c6e02d36dc66e091f5476f52c",        "timestamp": "1722929866"      }    ]  }}

Schema da GraphQL do Polymarket

O schema deste subgraph é definido aqui no GitHub do Polymarket⁠.

Ponto Final do Subgraph do Polymarket

https://gateway.thegraph.com/api/{api-key}/subgraphs/id/Bx1W4S7kDVxs9gC3s2G6DS8kdNBJNVhMviCtin2DiBp⁠

O ponto final do subgraph do Polymarket está disponível no Graph Explorer.

Ponto Final do Polymarket

Como Adquirir sua Própria Chave de API

  1. Entre em https://thegraph.com/studio e conecte a sua carteira de criptomoedas
  2. Crie uma chave de API em https://thegraph.com/studio/apikeys/

Esta chave de API vale para qualquer subgraph no Graph Explorer, não apenas no Polymarket.

Cem mil queries por mês de graça, perfeito para um projeto paralelo!

Subgraphs Adicionais do Polymarket

Como fazer Queries com a API

Qualquer query da GraphQL pode ser passada para o ponto final do Polymarket; os dados serão recebidos no formato json.

O exemplo de código a seguir retornará exatamente o mesmo resultado que acima.

Exemplo de Código do node.js

const axios = require('axios');const graphqlQuery = `{  positions(first: 5) {    condition    outcomeIndex  }};const queryUrl = 'https://gateway.thegraph.com/api/{api-key}/subgraphs/id/Bx1W4S7kDVxs9gC3s2G6DS8kdNBJNVhMviCtin2DiBp'const graphQLRequest = {  method: 'post',  url: queryUrl,  data: {    query: graphqlQuery,  },};// Mandar o query da GraphQLaxios(graphQLRequest)  .then((response) => {    // Controlar a resposta aqui    const data = response.data.data    console.log(data)  })  .catch((error) => {    // Controlar quaisquer erros    console.error(error);  });

Outros Recursos

Para mais informações sobre queries de dados do seu subgraph, leia mais aqui.

Para explorar todas as maneiras de otimizar e personalizar o seu subgraph por um desempenho melhor, leia mais sobre como criar um subgraph aqui.