For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Developer InformationAPI Reference
Developer InformationAPI Reference
  • Getting Started
    • Paradigm Overview
    • Onboarding
    • High-Level Notes
    • Authentication
    • Rate-Limits
    • Errors
    • Allowlisting URL`s
    • Security
  • Unified Markets
    • Summary
    • RFQ - Request For Quotes
    • OBv1
  • Delta-1 Spreads
    • Summary
    • High-Level Workflows
    • API Flows
  • What`s Changed
    • Auto-Populated Delta Hedge Quantity
    • Changes to Leg Level Validation
Logo
On this page
  • Error Object
  • Error Codes
Getting Started

Errors

Previous

Allowlisting URL's

Next
Built with

All RESToverHTTP error responses follow the same basic format. An Error object is returned in response to an erroneous RESToverHTTP request, accompanied by an HTTP status code of 400.

Specific error codes are listed with each RESToverHTTP endpoint.

Error Object

An example of an erroneous Response message

1{
2 "code": 1002,
3 "message": "Invalid enumeration set value",
4 "data": {
5 "member": "side",
6 "value": "CROSS"
7 }
8}

The Error object is expressed as a single JSON Object, with the following members:

MemberTypeReqDescription
codenumberYThe type of error that occurred.
messagestringYA short description of the error.
dataobjectNAdditional structured information about the error. The value is determined by the specific member invoked and may not be present if the error does not require it.

Error Codes

The following general error codes are supported by Paradigm:

CodeMessageMeaning
-32700Parse errorInvalid JSON received by the server.
-32600Invalid RequestThe JSON sent is not a valid Request object.
-32601Method not foundThe method does not exist / is not available.
-32602Invalid paramsInvalid method parameter(s).
-32603Internal errorInternal JSON-RPC error.
429Desk’s ratelimit reached. Expected available in 1 second.Refer to Rate Limit section above.
1001Insufficient permissionsThe user does not have sufficient permissions to execute the method.
1002Invalid enumeration set valueThe enumeration set value is invalid for the specified field.