Skip to Content
ErrorsCommon Errors

Common Errors

401 Missing API key or secret

Cause:

  • X-API-Key missing
  • both X-API-Secret and bearer secret missing

Fix:

  • Send X-API-Key and X-API-Secret
  • or send X-API-Key and Authorization: Bearer <secret>

401 Invalid API key or secret

Cause:

  • key/secret pair does not match
  • rotated or revoked credentials

Fix:

  • regenerate credentials in portal and update backend secrets

403 2FA setup required in portal

Cause:

  • operation is protected by B2B 2FA guard

Fix:

  • enable integration 2FA in portal before calling:
    • strategy creation
    • executeSwap
    • deposits / depositTokens
    • withdrawTokens

404 Not found

Cause:

  • user id, strategy id, pool id, swap id, deposit id, or withdraw id does not exist in your integration scope

Fix:

  • verify ids were created under the same integration key
  • verify userId is the external user id your client uses for that user (see Users — Identity model)
ChangelogQuickstart