Authentication

Get JWT

Authenticate using signed payload to get a JWT for usage in other endpoints

There are multiple valid headers required to be sent as part of this request.

For onboarding examples, refer to go, java and python code in code-samples.

StarkNet Message Hash and Signature

Inspired by EIP-712, (a standard for hashing and signing typed structured data) the encoding of an off-chain message is defined as:

signed_data = Enc[PREFIX_MESSAGE, domain_separator, account, hash_struct(message)]

where:

PREFIX_MESSAGE = "StarkNet Message"
domain_separator is defined as the hash_struct of the StarkNetDomain struct:
- Struct contains: name, chainId and version
- chainId is can be obtained calling GET /system/config
account is the StarkNet account address
The message to be hashed is represented as a struct
- hash_struct(message) = Enc[type_hash(MyStruct), Enc[param1], ..., Enc[paramN]]
- where type_hash is defined as in EIP-712 (but using selector instead of keccak)
- More details on StarkNet - Hash Functions

In case of more complex structure of object, you have to work in the spirit of EIP-712. This json structure has 4 mandatory items: types, primaryType, domain and message. These items are designed to be able to be an interface with a wallet. At sign request, the wallet will display:

message will be displayed at the bottom of the wallet display, showing clearly (not in hex) the message to sign. Its structure has to be in accordance with the type listed in primaryType, defined in types.
domain will be shown above the message. Its structure has to be in accordance with StarkNetDomain.

The predefined types that you can use :

felt : for an integer on 251 bits.
felt* : for an array of felt.
string : for a shortString of 31 ASCII characters max.
selector : for a name of a smart contract function.
merkletree : for a Root of a Merkle tree, calculated with the provided data.

Specification details: Signing transactions and off-chain messages

Message Hash Sample Code

For a complete message_hash example, refer to python code in code-samples.

Examples:

{
  "paradex-signature-expiration": 1682364556,
  "paradex-starknet-account": "0x129f3dc1b8962d8a87abc692424c78fda963ade0e1cd17bf3d1c26f8d41ee7a",
  "paradex-starknet-signature": [
    "1381323390094460587764867648394252677239485992175346764030313478865763678671",
    "396490140510115262427678549757564216013606350105112805717359873954984880589"
  ],
  "paradex-timestamp": 1681759756
}

post/auth

Headers

PARADEX-STARKNET-ACCOUNTstring required

Starknet account

PARADEX-STARKNET-SIGNATUREstring required

Starknet signature

PARADEX-TIMESTAMPstring required

Timestamp when the signature was created

PARADEX-SIGNATURE-EXPIRATIONstring

Timestamp when signature expires (default 30 min | Max 1 week)

PARADEX-AUTHORIZE-ISOLATED-MARKETSstring

Optional flag to authorize all isolated market accounts linked to the main account. When set to true, the returned JWT will grant trading access to all isolated accounts. Defaults to false if not specified

Response

jwt_tokenstring

Authentication token

Example response

{
  "jwt_token": "eyJhbGciOiJFUzM4NCIsInR5cCI6IkpXVCJ9.eyJ0eXAiOiJhdCtKV1QiLCJleHAiOjE2ODE0NTI5MDcsImlhdCI6MTY4MTQ1MjYwNywiaXNzIjoiUGFyYWRleCBzdGFnaW5nIiwic3ViIjoiMHg0OTVkMmViNTIzNmExMmI4YjRhZDdkMzg0OWNlNmEyMDNjZTIxYzQzZjQ3M2MyNDhkZmQ1Y2U3MGQ5NDU0ZmEifQ.BPihIbGhnnsuPlReqC9x12JFXldpswg5EdA6tTiDQm-_UHaRz_8RfVBqWc2fPN6CzFsXTq7GowZu-2qMxPvZK_fGcxEhTp2k1r8MUxowlUIT4vPu2scCwrsyIujlCAwS"
}

Changes

Changed in 8 of the 65 revisions of this API.26417

Jul 17, 2026f1370c46e9e86See the full diff
- ●
  added the new BLOCK_TRADE_REPLAYED_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_REPLAYED_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_VAULT_OPERATORS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_VAULT_OPERATORS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new VAULT_DATA_PRIVATE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new VAULT_DATA_PRIVATE enum value to the //// response property for the response status
  response-property-enum-value-added
Jun 9, 202643b81de9b0796See the full diff
- ○
  removed the INVALID_RHINOFI_QUOTE enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_QUOTE enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_QUOTE_COMMIT enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_QUOTE_COMMIT enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
May 21, 20267861dbd35cf54See the full diff
- ●
  added the new IP_NOT_ALLOWED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_NOT_ALLOWED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MARKET_NOT_SETTLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MARKET_NOT_SETTLED enum value to the //// response property for the response status
  response-property-enum-value-added
May 7, 2026d24c9b025e4b4See the full diff
- ●
  added the new BLOCK_TRADE_INVALID_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_INVALID_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_SIGNER_KEY_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_SIGNER_KEY_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
May 4, 20266540e7a44a838See the full diff
- ●
  added the new EVM_ADDRESS_ALREADY_ONBOARDED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_ADDRESS_ALREADY_ONBOARDED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_EVM_BALANCE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_EVM_BALANCE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_INVALID_ACCOUNT_KIND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_INVALID_ACCOUNT_KIND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_ONBOARDING_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_ONBOARDING_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
Apr 29, 2026b83876e772af6See the full diff
- ○
  removed the BAD_STARKNET_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the BAD_STARKNET_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PRICE_PRECISION enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PRICE_PRECISION enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the TRANSACTION_NOT_FOUND enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the TRANSACTION_NOT_FOUND enum value from the //// response property for the response status
  response-property-enum-value-removed
Apr 22, 202646a57608a7902422See the full diff
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ●
  added the new BLOCK_TRADE_ACCOUNT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_ACCOUNT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_EXPIRED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_EXPIRED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNERS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNERS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_TRADES enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_TRADES enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_ENABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_ENABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_SIGNATURE_VERIFICATION_FAILED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_SIGNATURE_VERIFICATION_FAILED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INVALID_EVM_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INVALID_EVM_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MEDIA_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MEDIA_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_NOT_ACCEPTING enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_NOT_ACCEPTING enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_CONFIG_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_CONFIG_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new SUBKEY_NOT_ACTIVATABLE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new SUBKEY_NOT_ACTIVATABLE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new XP_TRANSFERS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new XP_TRANSFERS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ○
  removed the INVALID_JOIN_WAITLIST_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_JOIN_WAITLIST_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
Dec 24, 2025846a2e2b455b3See the full diff
- ○
  added the media type application/json for the response with the status
  response-media-type-added
- ○
  added the media type application/json for the response with the status
  response-media-type-added
- ○
  added the media type application/json for the response with the status
  response-media-type-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history