Errors

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. 
Python SDK
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. 
Python SDK
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.
Python SDK
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.
Python SDK
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.
Python SDK
from flipside.errors import ApiError
​
try:
    sdk.query(sql)
except ApiError as e:
    print(f"an api error has occurred: {e.message}")
SDK Error
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 here as a Github Issue with a full stack-trace and detailed steps to reproduce.
Python SDK
from flipside.errors import SDKError
​
try:
    sdk.query(sql)
except SDKError as e:
    print(f"a client-side SDK error has occurred: {e.message}")
Rate Limits
More Examples
Last modified 7d ago