Error Codes

When making a request to our API, there may be times when an error is returned. If you are unable to resolve the issue, please contact us at [email protected] or via Telegram @berlincrypto.

Not Authorized (401)

Message: you should be authenticated to do this request

Resolution: Requires valid X-API-KEY header authentication. Check for token expiration or permission issues.

User Not Found (401)

Message: user not found

Resolution: Invalid or unknown API key. Check account status via [email protected].

Missing Limit Parameter (400)

Message: unable to parse paging argument: limit field is required

Resolution: The limit parameter is mandatory for list-returning queries.

Exceeding Maximum Limit (400)

Message: unable to parse paging argument: max limit is 500

Resolution: The limit parameter cannot exceed 500.

Invalid Argument (GRAPHQL_VALIDATION_FAILED)

Example: Typo detection like "metricss" vs "metrics"

Resolution: Check the suggestions provided for correct field names.

Variable Type Mismatch (GRAPHQL_VALIDATION_FAILED)

Example: Int cannot represent non-integer value: "1"

Resolution: Variables must match expected argument types.

Maximum Query Depth Exceeded (400)

Message: query path is too long. Max depth is 2

Resolution: Nested fields are limited to 2 levels.

Operation Not Found

Message: operation not found

Resolution: Occurs when request body lacks a valid query.

Field Conflict (GRAPHQL_VALIDATION_FAILED)

Description: Multiple fields with identical names but different arguments.

Resolution: Use aliases to differentiate fields with the same name.

{
  assets(where: { symbols: ["ETH"] }, limit: 1) {
    rewardRate: metrics(where: { metricKeys: ["reward_rate"] }, limit: 1) {
      defaultValue
    }
    price: metrics(where: { metricKeys: ["price"] }, limit: 1) {
      defaultValue
    }
  }
}