User API
Programmatic access to your account: orders, payment details, verification, balance, referrals, 2FA. Enable the key in your profile.
Your API key
The key is stored only in this browser. Enable API in your account, copy the key — examples below will use it.
Quick start
All User API methods are POST. Send the secret key in the X-Authorization header. Request body is application/x-www-form-urlencoded.
- Open Account → API Settings and enable API.
- Copy the key (profile button or the field above).
- Call any method below — the key is injected into the curl sample.
Authorization & base URL
Your exchanger base URL: https://en.thecrypto.expert
| Item | Value |
|---|---|
| Method | POST |
| Header | X-Authorization: YOUR_API_KEY |
| Content-Type | application/x-www-form-urlencoded |
| Response language | language parameter (ru / en / uk) |
curl -X POST 'https://en.thecrypto.expert/user-api-get-info' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en'
Response format
Success
{
"success": true,
"result": ["data"]
}
Error
{
"success": false,
"message": "Optional error message.",
"result": false
}
List pagination
Lists support page and limit. The response may include pagination: [total objects, current position].
Order statuses
The status filter accepts a numeric ID or a name with @, e.g. status=@completed.
| # | Name | Description |
|---|---|---|
0 |
@created |
Created |
1 |
@paid |
Paid |
2 |
@suspended |
Suspended |
3 |
@canceled |
Canceled |
4 |
@completed |
Completed |
User information
Returns a user object. Password hashes and confirmation tokens are hidden.
curl -X POST 'https://en.thecrypto.expert/user-api-get-info' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en'
Orders history
List of your exchange orders.
Optional filters
id
token
status
exchange_id
send_currency_id
receive_currency_id
curl -X POST 'https://en.thecrypto.expert/user-api-get-orders' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en' \
--data-urlencode 'status=@completed'
Referral orders
Orders of your referrals. Some sensitive fields are hidden.
Optional filters
id
token
status
exchange_id
send_currency_id
receive_currency_id
curl -X POST 'https://en.thecrypto.expert/user-api-get-referral-orders' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en'
Payment details list
Saved user payment details.
Optional filters
currency_id
value
curl -X POST 'https://en.thecrypto.expert/user-api-get-details' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en'
Save payment details
Get currency_id from /public-api-get-currencies.
Parameters
| Name | Description |
|---|---|
currency_id |
Currency ID · required |
value |
Payment details · required |
curl -X POST 'https://en.thecrypto.expert/user-api-create-details' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en' \
--data-urlencode 'currency_id=77' \
--data-urlencode 'value=TXyz...'
Delete payment details
Multiple IDs are allowed.
Parameters
| Name | Description |
|---|---|
ids[] |
Detail ID or multiple IDs · required |
curl -X POST 'https://en.thecrypto.expert/user-api-delete-details' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en' \
--data-urlencode 'ids[]=291'
Verification status
Returns a verification request object.
curl -X POST 'https://en.thecrypto.expert/user-api-get-verification' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en'
Submit verification
Third-party services may need no params. Card verification needs number, name and photos.
Parameters
| Name | Description |
|---|---|
id_type |
Document type · optional |
id_number |
Document number · optional |
card_number |
Card number · optional |
first_name |
First name · optional |
last_name |
Last name · optional |
middle_name |
Middle name · optional |
birth_date |
Birth date (dd.mm.yyyy) · optional |
phone |
Phone · optional |
country |
Country · optional |
city |
City · optional |
address |
Address · optional |
zip_code |
ZIP code · optional |
photos[] |
Photos · optional |
curl -X POST 'https://en.thecrypto.expert/user-api-submit-verification' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en'
Pay from balance
Pay an exchange order from internal balance.
Parameters
| Name | Description |
|---|---|
token |
Order token · required |
two_factor_authentication_password |
2FA password (if enabled) · optional |
curl -X POST 'https://en.thecrypto.expert/user-api-spend-balance' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en' \
--data-urlencode 'token=ORDER_TOKEN'
Change password
Change account password.
Parameters
| Name | Description |
|---|---|
password |
Current password · required |
new_password |
New password · required |
two_factor_authentication_password |
2FA password (if enabled) · optional |
curl -X POST 'https://en.thecrypto.expert/user-api-change-password' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en'
2FA setup
Generate the secret yourself and send it only when enabling 2FA.
Parameters
| Name | Description |
|---|---|
two_factor_authentication_token |
Secret key · optional |
two_factor_authentication_enable |
1 enable / 0 disable · required |
two_factor_authentication_password |
2FA password · required |
curl -X POST 'https://en.thecrypto.expert/user-api-setup-two-factor-authentication' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en'
Saved exchange fields
Array: direction field ID → value.
curl -X POST 'https://en.thecrypto.expert/user-api-get-inputs' \
--header 'X-Authorization: {{API_KEY}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'language=en'
Useful public methods
No key required (GET). Use them for currency_id and exchange directions:
/public-api-get-currencies
/public-api-get-exchanges
/public-api-get-exchange
/public-api-get-status
/public-api-get-referral-program
curl -X GET 'https://en.thecrypto.expert/public-api-get-currencies?language=en'