The SDK implements the following errors that can be handled when calling the query method:
Query RunTime Errors
QueryRunRateLimitError
Occurs when you have exceeded the rate limit for creating/running new queries.
from flipside.errors import QueryRunRateLimitError
try:
sdk.query(sql)
except QueryRunRateLimitError as e:
print(f"you have been rate limited: {e.message}")
QueryRunTimeoutError
Occurs when your query has exceeded the timeout_minutes parameter passed into the query method.
from flipside.errors import QueryRunTimeoutError
try:
sdk.query(sql, timeout_minutes=10)
except QueryRunTimeoutError as e:
print(f"your query has taken longer than 10 minutes to run: {e.message}")
QueryRunExecutionError
Occurs when your query fails to compile/run due to malformed SQL statements.
from flipside.errors import QueryRunExecutionError
try:
sdk.query(sql)
except QueryRunExecutionError as e:
print(f"your sql is malformed: {e.message}")
Server Error
ServerError - occurs when there is a server-side error that cannot be resolved. This typically indicates an issue with Flipside Crypto's query engine API. If the issue persists please contact support in the Flipside Crypto discord server.
from flipside.errors import ServerError
try:
sdk.query(sql)
except ServerError as e:
print(f"a server-side error has occurred: {e.message}")
API Error
ApiError - this typically occurs when you, the user, submit a bad request to the API. This often occurs when an invalid API Key is used, or invalid object IDs are requested.
from flipside.errors import ApiError
try:
sdk.query(sql)
except ApiError as e:
print(f"an api error has occurred: {e.message}")
SDK Error
from flipside.errors import SDKError
try:
sdk.query(sql)
except SDKError as e:
print(f"a client-side SDK error has occurred: {e.message}")
SDKError - this error is raised when a generic client-side error occurs that cannot be accounted for by the other errors. SDK level errors should be reported as a Github Issue with a full stack-trace and detailed steps to reproduce.
