> For the complete documentation index, see [llms.txt](https://concise-labs.gitbook.io/introduction/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://concise-labs.gitbook.io/introduction/get-started/graphql-api.md).

# GraphQL API

We provide GraphQL API for solana programs instead of REST API because GraphQL is flexible, fast and developer-friendly. You can choose to query for the exact data you want from the program accounts and get it faster.

## How to get data from GraphQL API?

### Using curl

You can use a simple curl command to pass the query and get your desired data.

```
curl -X POST -H "Content-Type: application/json" -H "x-hasura-admin-secret: {your_admin_secret}" -d '{"query": "user { authority }"}' https://yourprogram.conciselabs.io/v1/graphql
```

### Using GraphiQL

You can also play around with the queries using GraphiQL - <https://cloud.hasura.io/public/graphiql>

### GraphQL Clients

There are many GraphQL clients available. Listing some of them below for your reference.

1. <https://graphql.org/code/#javascript-client>
2. <https://graphql.org/code/#python-client>
3. <https://graphql.org/code/#rust-client>
4. <https://graphql.org/code/#java-kotlin-client>
5. <https://graphql.org/code/#swift-objective-c-client>

## Examples

Sample Query 1

```
curl -X POST \
-H "Content-Type: application/json" \
-H "x-hasura-admin-secret: {your_admin_secret}" \
-d '{"query": "query StakeAccount {\n stakeaccount {\n bondedshares\n owner\n stakepool\n unbondingshares\n voterweightrecord\n  }\n}"}' \
https://super-stag-90.hasura.app/v1/graphql
```

Response

```
{
  "data": {
    "stakeaccount": [
      {
        "bondedshares": 0,
        "owner": "BubwQg3rMQFk9V1DZSP5KFeZ4pNJh5RHc3Kh9SHnfY7j",
        "stakepool": "4o7XLNe2NYtcxhFpiXYKSobgodsuQvHgxKriDiYqE2tP",
        "unbondingshares": 0,
        "voterweightrecord": "8GB8uK5y5wHKG28s4d5WF2hwGJQqopUNUYocgDfa3riK"
      },
      {
        "bondedshares": 327694027,
        "owner": "7skH3e6qq2wo7LwPJGz4MJ4xUKK6NYR2Y7Qw57g2CZqG",
        "stakepool": "4o7XLNe2NYtcxhFpiXYKSobgodsuQvHgxKriDiYqE2tP",
        "unbondingshares": 0,
        "voterweightrecord": "AuqPcsbFS5VyjnAaQqLosaXAJDGa9bDji4Uy3K7c8nLj"
      },
      {
        "bondedshares": 41983899522,
        "owner": "5VzraLSQ96QinHQPt5K3MUPijczZJCy7r6PSZzunGTxL",
        "stakepool": "4o7XLNe2NYtcxhFpiXYKSobgodsuQvHgxKriDiYqE2tP",
        "unbondingshares": 0,
        "voterweightrecord": "BFrhyYCgyJDx2XPzZ42iGXbSqbRLx1x55vo4tP9Shfuy"
      },
      ...
      ...
      {
        "bondedshares": 839848739,
        "owner": "4B6pBb6RXdYMVMrkj9eyWaz3Ljs6Y7uDrm8iKd5WwcX2",
        "stakepool": "4o7XLNe2NYtcxhFpiXYKSobgodsuQvHgxKriDiYqE2tP",
        "unbondingshares": 0,
        "voterweightrecord": "kQH4rEG4deX93havJRTdXYzr6iTQFVaiggpi1VqPFZ5"
      }
    ]
  }
}
```

Sample Query 2

```
curl -X POST \
-H "Content-Type: application/json" \
-H "x-hasura-admin-secret: {your_admin_secret}" \
-d '{"query": "query StakePool {\n  stakepool {\n authority\n bonded\n bumpseed\n governancerealm\n maxvoterweightrecord\n seed\n seedlen\n stakecollateralmint\n stakepoolvault\n tokenmint\n unbonding\n unbondperiod\n vaultamount\n  }\n}"}' \
https://super-stag-90.hasura.app/v1/graphql
```

Response

```
{
  "data": {
    "stakepool": [
      {
        "authority": "CkkWJtdPoq22CVdfWBhV5vo9MXNVaPXJAjrVmsRpYGC1",
        "bonded": {
          "tokens": "1eb510c6f410c9",
          "shares": "3ab3ba54366d36"
        },
        "governancerealm": "78TbURwqF71Qk4w1Xp6Jd2gaoQb6EC7yKBh5xDJmq6qh",
        "maxvoterweightrecord": "3jNVDLb7bj4jYCzVKxbMqA5zE7eKkq3osLR7s9Qpwbm2",
        "stakecollateralmint": "11111111111111111111111111111111",
        "stakepoolvault": "CoiMvpzT7pPmncy81XvsLvfjvXKdkE4TgsYFpEY8Zroc",
        "tokenmint": "JET6zMJWkCN9tpRT2v2jfAmm5VnQFDpUBCyaKojmGtz",
        "unbonding": {
          "tokens": "0170a3cdf9a76e",
          "shares": "0e66660bc08a4c"
        },
        "unbondperiod": 2551443,
        "vaultamount": 9048656777689144
      }
    ]
  }
}
```