Skip to main content
POST
/
api
/
v1
/
token
User Authentication
curl --request POST \
  --url https://api-auth.trade.rails.xyz/api/v1/token \
  --header 'X-Api-Key: <x-api-key>' \
  --header 'X-Api-Secret: <x-api-secret>'
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhY2NvdW50VHlwZSI6InJldGFpbCIsImlzcyI6InN0YWdpbmcuZnVuZ2libGUueHl6Iiwic3ViIjoiNDcwMGYyODItMGFkNC00ZjU1LWIxNDItZGUzZTYwZDVkMTFlIiwiYXVkIjpbInN0YWdpbmctYXBwLmZ1bmdpYmxlLnh5eiJdLCJleHAiOjE3MTA4ODIxNzAsImlhdCI6MTcxMDg4MDM3MH0.Vgh_zKUgPSOPbVQ7nTHVg6jCYZ59nSJwqx6pfSDfGss",
  "token_type": "Bearer",
  "expires_in": 1800
}
See rate limit applied to this endpoint.

​
Setup Required

You need to set up your API Keys first before using this endpoint.

​
Token Management

The generated token expires every 30 minutes. Since tokens remain valid for this duration, we recommend caching and reusing the token within your application to minimize unnecessary requests and avoid hitting the rate limit.

Headers

​
X-Api-Key
string
required

The API key for the user

​
X-Api-Secret
string
required

The API secret for the user

Response

​
access_token
string

The access token used for API authentication

​
token_type
string

The type of token returned, typically Bearer

​
expires_in
integer

The number of seconds until the token expires

⌘I