Error catalog

Every error response carries a stable code in the errors object (see Conventions for the response envelope). This table is generated directly from the API’s error definitions, so it never drifts from what the server actually returns.

Code	Error	HTTP status	Meaning	Retryable
1000	EventNotFound	404	The specified event does not exist in the database.	No
1001	RequestInputValidationError	400	The request input did not pass validation checks.	No
1002	RequestValidationError	400	The response data structure does not match the expected schema.	No
1003	InternalError	500	An unexpected error occurred on the server, Please try again later.	Yes
1004	UnAuthorize	401	An unexpected error occurred while processing your request. Please try again later.	No
1005	ActiveEventCannotUpdate	400	The specified event is active and cannot be updated.	No
1006	MarketMakerNotFound	404	The specified market maker does not exist.	No
1007	MarketMakerNotMainAccount	403	This action is limited to the account holding the firm’s market-data API key. A sub-account can only act on itself.	No
1008	MarketMakerSubAccountNotFound	404	No active sub-account with this id exists under your market-making firm.	No
1009	MarketMakerAccountTooNewToRotate	403	A main account must exist for at least 24 hours before it can rotate its market-data API key.	No
1010	MarketMakerActionNotPermitted	403	The firm’s main account has turned this permission off for your sub-account. Ask your main account to re-enable it.	No
1011	MarketMakerPermissionsDisabled	403	Per-sub-account permissions have not been switched on for this market-making firm. Contact support.	No
1012	MarketMakerCannotEditOwnPermissions	400	Permissions apply to sub-accounts only. The main account is never restricted.	No
1013	MarketNotFound	404	The specified market does not exist.	No
1014	PostNotFound	404	The specified post does not exist in the database.	No
1015	CommentNotFound	404	The specified comment does not exist in the database.	No
1016	InvalidPredictionSide	400	The prediction side must be either “yes” or “no”.	No
1017	MarketIdRequiredWithSide	400	You must provide a marketId when specifying a prediction side.	No
1018	BookmarkAlreadyExists	409	This post is already in your bookmarks.	No
1019	BookmarkNotFound	404	The specified bookmark does not exist.	No
1429	TooManyRequests	429	You have exceeded the allowed number of requests. Please slow down and try again later.	Yes
3005	UserNotExists	400	An unexpected error occurred while processing your request. Please try again later.	No
3021	UserAlreadyExists	409	An unexpected error occurred while processing your request. Please try again later.	No
3025	InvalidToken	401	The provided token is invalid or has expired. Please request a new token.	No
3026	InvalidCredentials	401	The email or password provided is incorrect. Please try again.	No
3027	RefreshTokenNotFound	401	No refresh token was provided. Please log in again.	No
3028	InvalidRefreshToken	401	The provided refresh token is invalid or expired. Please log in again.	No
3029	RefreshTokenRevoked	401	The refresh token is no longer valid. Please log in again.	No
3078	InvalidOtp	400	An unexpected error occurred while processing your request. Please try again later.	No
3114	EmailAlreadyVerified	409	An unexpected error occurred while processing your request. Please try again later.	No
3121	EmailNotVerified	403	An unexpected error occurred while processing your request. Please try again later.	No
3154	VeriffMissingRequiredUserDetails	400	User details are incomplete. First complete the profile with required information.	No
3155	VeriffAlreadyVerifiedErrorType	422	KYC verification is already done	No
3173	VeriffError	400	Veriff API error.	No
3180	AgeRestrictionError	400	The user does not meet the minimum age requirement of 18 years.	No
3181	InvalidDateOfBirth	400	The provided date of birth is not in a valid format.	No
3182	UserNameExists	409	The username is already taken. Please choose a different one.	No
3183	KycNotVerified	403	User KYC is not verified. Please complete KYC to proceed.	No
3184	AccountLocked	403	Your account has been temporarily locked due to multiple failed login attempts. Please try after 24 hours.	No
3185	SameAsOldPassword	400	Your new password cannot be the same as your old password. Please choose a different password.	No
3186	MfaMethodsRequired	400	You must enable at least one MFA method (email or SMS) to use MFA features.	No
3187	SsnAlreadyInUse	409	This SSN is already associated with another account.	No
3188	EmailAlreadyInUse	409	This email is already in use.	No
3189	PhoneAlreadyVerified	409	This phone number is already verified on your account.	No
3190	InvalidRequest	400	The request is missing required fields or contains invalid data.	No
3191	MfaNotSetup	400	Set up the authenticator app before verifying a code.	No
3192	MfaAlreadyEnabled	400	Authenticator MFA is already active for this account.	No
3193	MfaInvalidCode	400	The 6-digit code from the authenticator app is invalid or has expired.	No
3194	InvalidFileType	400	Only PNG, JPEG, GIF, and WebP image files are allowed.	No
3195	FileTooLarge	400	The uploaded file exceeds the maximum allowed size of 3 MB.	No
3200	AccountSuspended	403	Your account has been suspended. Please contact support.	No
3201	PasswordNotReset	400	Your password reset link has been expired. Please try again.	No
3202	WrongPassword	400	Your old password is incorrect. Please try again.	No
3203	InvalidGoogleToken	401	Google token verification failed. Please try again.	No
3204	OtpEmailError	500	There was an issue sending the OTP to the email. Please try again later.	Yes
3205	ResetPasswordEmailError	500	There was an issue sending the email to the user for reset password. Please try again later.	Yes
3206	Access token creation error	500	There was an issue creating the access token. Please try again later.	Yes
3207	PhoneAlreadyInUse	409	This phone number is already associated with another account.	No
3208	MissingTurnstileToken	400	The ‘cf-turnstile-response’ was not provided in the request.	No
3209	TurnstileFailed	403	Cloudflare Turnstile could not verify this request as human. Possible invalid or expired token.	No
3210	InvalidState	400	The selected state is not available. Please choose a valid state from the provided list.	No
4001	OrderNotFound	404	The specified order does not exist.	No
4002	OrderNotOwned	403	You do not have permission to modify this order.	No
4003	OrderNotCancellable	400	This order is already filled, cancelled, or in a non-cancellable state.	No
4004	OrderNotModifiable	400	This order is already filled, cancelled, or in a non-modifiable state.	No
4005	MarketNotActive	400	Orders cannot be cancelled or modified when the market is not active.	No
4006	InvalidQuantity	400	The new quantity must be greater than 0.	No
4007	InsufficientFundsForModify	400	You do not have enough available balance to increase this order.	No
4008	InsufficientContractsForModify	400	You do not have enough available contracts to increase this order.	No
4009	MarketNotOpenForTrading	400	The market must be in OPEN status to accept, cancel, or modify orders.	No
4010	MarketHalted	400	The market has been halted. No new orders or modifications are permitted until trading resumes.	No
4011	UserOpenOrderLimitExceeded	400	The total open contracts would exceed the per-user limit configured for this market.	No
4012	OrderExpirationPast	400	The specified expiration time has already passed.	No
4013	OrderExpirationTooLate	400	Orders cannot be set to expire after the market or event itself has expired.	No
4014	PositionSizeLimitExceeded	422	Placing this order would push your total position beyond the allowed limit for this market.	No
4015	MaxOrderSizeExceeded	422	The number of contracts in this single order is above the maximum order size configured for this market.	No
4016	DailyPriceLimitExceeded	422	The order price is beyond the upper/lower price boundary set for this market for the current trading day.	No
4017	PriceBandExceeded	422	The order price is too far from the current market price. Adjust the price to within the configured band.	No
4018	NoPositionForSell	422	You must own contracts in this market before you can sell them.	No
4019	UserDailyDepositLimitExceeded	422	This deposit would push your deposits over the last 24 hours beyond the daily deposit limit you configured on your profile.	No
4021	DailyLimitChangeLocked	403	Daily trading/deposit limits can only be changed once every 24 hours after being set, changed, or removed.	No
4022	ModificationFailed	500	An error occurred while modifying the order. Please try again later.	Yes
4023	CancellationFailed	500	An error occurred while cancelling the order. Please try again later.	Yes
4024	OrderSubmissionFailed	500	An error occurred while submitting the order. Please try again later.	Yes
4300	RfqNotFound	404	The specified request for quote does not exist.	No
4301	RfqInvalidState	409	The RFQ changed state before this request was applied — it may have expired, been cancelled, or already been accepted.	No
4302	RfqBelowMinimum	422	RFQs are for block-sized interest. Submit smaller size as an ordinary order instead.	No
4303	RfqQuoteNotFound	404	The specified quote does not exist, or does not belong to this RFQ.	No
4304	RfqQuoteSuperseded	409	The market maker replaced or withdrew this quote before it was accepted. Re-read the RFQ for the current prices.	No
4305	RfqQuoteNotOwned	404	The quote belongs to a different market-making firm.	No
4306	RfqConfirmWindowClosed	409	The maker did not confirm within the configured window, so the RFQ was timed out.	No
4307	RfqNotOwned	404	This RFQ belongs to another user.	No
4308	RfqQuoteExceedsTargetCost	422	Accepting this quote would exceed the RFQ target cost. Raise the target or accept a cheaper quote.	No
4309	RfqInsufficientFundsAtRelease	422	Funds are not reserved while an RFQ is negotiated, and the balance is no longer sufficient to cover the agreed size.	No
4310	RfqReleaseFailed	500	The agreed orders could not be published to the matching engine.	Yes
4311	RfqSelfTradeBlocked	422	The matching engine will not cross two orders belonging to the same market-making firm, so this pairing could never trade.	No
4312	RfqTooManyOpen	429	Each open request is sent to every market maker to price. Cancel one or wait for it to expire before raising another.	Yes
4313	RfqMakerInsufficientFundsAtRelease	422	The market maker no longer holds the funds or contracts needed for the quote they confirmed, so no orders were placed and nothing was charged.	No
4400	ComboCreationDisabled	503	The platform has temporarily paused creating new Combo markets.	Yes
4401	ComboInvalidLegCount	422	A Combo must have between the configured minimum and maximum number of legs.	No
4402	ComboDuplicateLegMarket	422	The same market was supplied more than once, with the same or conflicting sides. Remove the duplicate.	No
4403	ComboInvalidSide	422	A Combo leg side was missing or not one of the two valid values.	No
4404	ComboLegMarketNotFound	404	Every marketTicker supplied for a Combo leg must resolve to an existing market, and an optional eventTicker must match that market’s actual event.	No
4405	ComboLegMarketNotEligible	422	A leg market’s status must be ‘open’ or ‘halted’ to be combined into a Combo.	No
4406	ComboNotFound	404	The specified Combo market does not exist.	No
4407	ComboCreationRace	409	The normalized_key unique constraint rejected this insert because another request for the exact same leg set committed first. Retrying the identical request resolves via the pre-check and returns the winner’s Combo.	Yes
5001	InsufficientFunds	400	You do not have enough available balance to complete this withdrawal.	No
5002	ExternalWalletInsufficientFunds	422	Your partner wallet’s balance does not cover this order.	No
5003	ExternalWalletUnavailable	502	The partner wallet could not be reached to verify your balance. Please try again shortly.	Yes
5004	ExternalWalletManaged	403	Deposits and withdrawals for this account are handled by your partner, not DimeTrades.	No
5005	ExternalWalletMarketOrderNotAllowed	422	A market BUY has no price to size your reservation against. Place a limit order instead; SELL market orders are unaffected.	No
6001	InvalidIp	400	The client IP address could not be determined.	No
6002	IpBlocked	403	Access from this IP address is blocked.	No
6003	VpnBlocked	403	Access from VPN or proxy networks is not allowed.	No
6004	UserStateBlocked	403	Access from your location is not allowed.	No
6005	UserLocationNotFound	400	Unable to determine your location.	No
6006	ExternalApiError	502	Unable to fetch geo location data at this time.	Yes
11001	TicketNotFound	404	The specified ticket does not exist.	No
11002	TicketNotOwned	403	You do not have permission to view or modify this ticket.	No
11003	TicketClosedOrResolved	400	This ticket has been resolved or closed and cannot accept new replies.	No
11004	DuplicateOpenTicket	409	Please wait until your existing ticket for this issue is resolved or closed before creating a new one.	No
12001	AlreadyJoinedLeaderboard	409	You are already a participant in this leaderboard metric.	No
12002	NotInLeaderboard	404	You have not joined this leaderboard metric.	No
12003	InvalidLeaderboardMetric	400	The metric_name must be one of: volume, projected_pnl, accuracy.	No
13001	CannotFollowSelf	400	Users are not allowed to follow their own account.	No
13002	AlreadyFollowing	409	A follow relationship already exists between these users.	No
13003	FollowRequestPending	409	A pending follow request already exists for this user.	No
13004	NotFollowing	404	No follow relationship exists to remove.	No
13005	FollowRequestNotFound	404	The specified follow request does not exist or is not pending.	No
13006	TargetUserNotFound	404	The specified user does not exist.	No
13007	ProfileNotAccessible	403	You do not have permission to view this profile. Follow the user to access their profile.	No
13008	VisibilityRestricted	403	The user has restricted visibility for this data.	No
14001	CmsNotFound	404	The specified CMS page does not exist or is inactive.	No
15001	MaintenanceMode	503	The service is temporarily unavailable due to scheduled maintenance.	Yes
17001	BrandUnauthorized	401	The X-API-Key / X-API-Secret pair is missing or does not match an active credential.	No
17002	BrandInactive	403	This brand has been suspended and can no longer make partner API calls.	No
17003	CustomerNotFound	404	No customer with this externalCustomerId has been registered for this brand.	No
17004	DeviceSessionNotFound	404	No active refresh session exists for this device. The session may have already been revoked or expired.	No
17005	MaxUserSessionsReached	403	This user already has the maximum allowed number of active sessions/devices.	No

How to use `retryable`

Yes — the failure is transient (rate limiting, a downstream timeout, an internal error). Back off and retry the same request.
No — the failure is about the request itself (validation, ownership, business-rule rejection). Retrying with the same input will fail again; fix the input or surface the error to the user instead.

Getting started

Reference

Events & markets

Webhooks

External Wallet

WebSockets

How to use `retryable`

​How to use retryable

How to use `retryable`