Best practices

Following these best practices will help you build faster, more reliable integrations with The Grid API. These guidelines are based on real-world usage patterns and optimized for performance, maintainability, and cost efficiency.

Query Optimization

DO
Use limit parameter to control result size
Request only the fields you need
Use slugs for enum filtering (e.g., productType: {slug: {_eq: "wallet"}})
Paginate large result sets
Cache responses when possible

DON'T
Fetch all records without limits
Request deeply nested data unnecessarily
Use IDs for filtering (use slugs instead)
Run the same query repeatedly without caching

Search strategies

DO
Start Broad, Narrow Down
name: {_like: "%wallet%"} → productType: {slug: {_eq: "wallet"}} → productStatus: {slug: {_eq: "live"}}
Use Relationships
Find asset → Query products supporting asset → Filter by type
Leverage Multiple Fields
Search by name, ticker, description, social handles

Field Selection

Specific fields
products {
  name
  productType { slug }
}

Over-fetching
products {
  # All fields
}