> For the complete documentation index, see [llms.txt](https://devs.maxapy.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devs.maxapy.io/maxapy-erc4626/subgraph/query-guide.md).
# Query Guide
## Common Queries
### Query Vault Data
```graphql
query getVaultData($vaultId: ID!) {
vault(id: $vaultId) {
id
totalAssets
pricePerShare
strategies {
id
name
totalDebt
totalGain
isActive
}
harvests(orderBy: timestamp, orderDirection: desc, first: 10) {
timestamp
gain
loss
}
}
}
```
### Query User Account Data
```graphql
query getUserData($accountId: ID!) {
account(id: $accountId) {
id
vaultBalances {
vault {
id
underlyingToken {
symbol
}
}
shareBalance
netDeposits
}
deposits(orderBy: timestamp, orderDirection: desc) {
amount
timestamp
}
}
}
```
### Query Strategy Performance
```
query getStrategyPerformance($strategyId: ID!) {
strategy(id: $strategyId) {
id
name
totalGain
totalLoss
isActive
vault {
id
totalAssets
}
}
}
```
***
## Developer Resources
### Real-time Updates
Subscribe to real-time updates using GraphQL subscriptions:
```graphql
subscription onHarvest {
harvest(orderBy: timestamp, orderDirection: desc) {
id
strategy {
name
}
gain
loss
timestamp
}
}
```
### Error Handling
The subgraph API uses the standard GraphQL error format. Common error scenarios:
1. Entity Not Found: Returns null for the requested entity
2. Invalid Query: Returns a GraphQL validation error
3. Network Issues: Check the `_meta` field for indexing status
Example error check:
```graphql
query checkIndexingStatus {
_meta {
hasIndexingErrors
block {
number
}
}
}
```
### Rate Limits and Best Practices
1. Implement pagination for large result sets using `first` and `skip` parameters
2. Use specific field selection instead of requesting all fields
3. Cache frequently accessed data client-side
4. Monitor your query complexity and response times
5. Consider implementing retry logic for failed queries
### SDK Integration
For TypeScript/JavaScript applications, you can generate typed clients using:
* GraphQL Code Generator
* Apollo Codegen
* URQL Codegen
Example type generation command:
```bash
graphql-codegen --config codegen.yml
```