Sui.

Post

Share your knowledge.

HaGiang.
Jul 21, 2025
Expert Q&A

is the GraphQL ready to use in mass-production?

Because it is still [Alpha] in API docs https://docs.sui.io/references/sui-graphql

And also we seems can only use it via a specific node https://sui-mainnet.mystenlabs.com instead of regular full node url like https://fullnode.mainnet.sui.io. Curious if this mysten node have any rate-limiting?

  • Sui
4
4
Share
Comments
.

Answers

4
0xduckmove.
Jul 26 2025, 11:30

You can use Sui GraphQL for development and testing, but it is not yet recommended for mass production, as it's still marked [Alpha] in the official API docs. This means the interface is still evolving, and production usage might lead to unexpected issues, such as schema changes or instability. Also, it's currently accessible only through a specific endpoint—https://sui-mainnet.mystenlabs.com—rather than through standard Sui full node URLs like https://fullnode.mainnet.sui.io. This limitation signals that GraphQL is being served via a dedicated Mysten Labs node, not a decentralized infrastructure.

Because it's hosted by Mysten Labs, you should expect rate limiting, especially if you send high-frequency queries or use it in a public-facing app. There’s no official documentation outlining those rate limits yet, so your safest approach is to throttle queries manually and use retries or fallbacks. For mission-critical apps, stick with the JSON-RPC API and use GraphQL only for convenience or read-heavy, non-critical queries.

To stay updated on production readiness and limits, check the Sui GraphQL doc: https://docs.sui.io/references/sui-graphql

Transaction Block Note GraphQL does not support sending transactions yet—only reading data—so you still need to use Sui JSON-RPC or CLI like:

sui client call --function transfer --package 0xabc123 --args 0xrecipient 100 --gas-budget 10000000 Until GraphQL exits Alpha, consider it a powerful tool for exploration but not your main production pipeline.

4
Best Answer
Comments
.
harry phan.
Jul 23 2025, 02:59

t's very much a "use at your own risk" thing at the moment -- you can see the roadmap and timelines here: https://docs.sui.io/guides/developer/getting-started/data-serving#graphql-rpc, we are currently working on getting the beta version out, and then hopefully general release (with multiple RPC providers offering) by the end of the year. Out of interest, which feature is it that you need?

11
Comments
.
Meaning.Sui.
Jul 26 2025, 11:35

Transaction Block Note GraphQL does not support sending transactions yet—only reading data—so you still need to use Sui JSON-RPC or CLI like:

sui client call --function transfer --package 0xabc123 --args 0xrecipient 100 --gas-budget 10000000 Until GraphQL exits Alpha, consider it a powerful tool for exploration but not your main production pipeline.

7
Comments
.
shamueely.
Jul 21 2025, 18:51

You can use Sui GraphQL for development and testing, but it is not yet recommended for mass production, as it's still marked [Alpha] in the official API docs. This means the interface is still evolving, and production usage might lead to unexpected issues, such as schema changes or instability. Also, it's currently accessible only through a specific endpoint—https://sui-mainnet.mystenlabs.com—rather than through standard Sui full node URLs like https://fullnode.mainnet.sui.io. This limitation signals that GraphQL is being served via a dedicated Mysten Labs node, not a decentralized infrastructure.

Because it's hosted by Mysten Labs, you should expect rate limiting, especially if you send high-frequency queries or use it in a public-facing app. There’s no official documentation outlining those rate limits yet, so your safest approach is to throttle queries manually and use retries or fallbacks. For mission-critical apps, stick with the JSON-RPC API and use GraphQL only for convenience or read-heavy, non-critical queries.

To stay updated on production readiness and limits, check the Sui GraphQL doc: https://docs.sui.io/references/sui-graphql

Transaction Block Note GraphQL does not support sending transactions yet—only reading data—so you still need to use Sui JSON-RPC or CLI like:

sui client call --function transfer --package 0xabc123 --args 0xrecipient 100 --gas-budget 10000000

Until GraphQL exits Alpha, consider it a powerful tool for exploration but not your main production pipeline.

0
Comments
.

Do you know the answer?

Please log in and share it.