GET POST

/user/info

Get general information about a user.

Query Params / Form Data

key string
abcdefghijklmnopqrstuvwxyz0123

Contains your API key.
Get it from here.

user_id string required
abcdefghijklmnopqrstuvwxyz0123

The unique ID of the user whose information you wish to retrieve.
This ID is required.

include_logo boolean

A flag to indicate whether to include the user's logo in the response.
Set to "1" to include, or "0" to exclude the logo.

Response JSON

status string required

Indicates the result of the API request.
For more details about error handling, check here.

uid string required
abcdefghijklmnopqrstuvwxyz0123

The unique ID of the user.

storename string
Example Store

The name of the user's store.

payment_methods array required
payment method specific

Payment method data for a user.

logo string
base64

The base64-encoded image string representing the user's logo.

GET POST

/user/transactions

Get a users transactions.

Query Params / Form Data

key string required
abcdefghijklmnopqrstuvwxyz0123

Contains your API key.
Get it from here.

user_id string required
abcdefghijklmnopqrstuvwxyz0123

The unique ID of the user whose transactions you wish to retrieve.
This ID is required.

rows integer
10

The number of transactions to return per page.
This parameter is optional. If provided, it must be used with the `page` parameter.

page integer
1

The page number to retrieve.
This parameter is optional. If provided, it must be used with the `rows` parameter.

Response JSON

status string required

Indicates the result of the API request.
For more details about error handling, check here.

transactions array required
uid, amount_topay, currency, status, payment_method, created, expires, cancelled, completed

A list of transactions associated with the user.

GET POST

/user/funds

Get a users funds.

Query Params / Form Data

key string required
abcdefghijklmnopqrstuvwxyz0123

Contains your API key.
Get it from here.

user_id string required
abcdefghijklmnopqrstuvwxyz0123

The unique ID of the user whose funds you wish to retrieve.
This ID is required.

rows integer
10

The number of funds records to return per page.
This parameter is optional. If provided, it must be used with the `page` parameter.

page integer
1

The page number to retrieve.
This parameter is optional. If provided, it must be used with the `rows` parameter.

Response JSON

status string required

Indicates the result of the API request.
For more details about error handling, check here.

funds array required
uid, amount, currency, type, time

A list of funds associated with the user.

GET POST

/user/balances

Get a users balances.

Query Params / Form Data

key string required
abcdefghijklmnopqrstuvwxyz0123

Contains your API key.
Get it from here.

user_id string required
abcdefghijklmnopqrstuvwxyz0123

The unique ID of the user whose balances you wish to retrieve.

Response JSON

status string required

Indicates the result of the API request.
For more details about error handling, check here.

currency string required

The currency in which the balance is denominated.
Can be configured here.

total_balance number required
11.55

The total balance of the user, denominated in the users currency.

balances object required
currency: actual, converted

An object containing the balances for currencies the user owns.
The actual amount indicates the amount in the currency.
The converted amount indicates the amount converted to the users currency.

GET POST

/user/stats

Retrieve statistics about a user's transactions, including revenue, transaction count, and completion rates.

Query Params / Form Data

key string required
abcdefghijklmnopqrstuvwxyz0123

Contains your API key.
Get it from here.

user_id string required
abcdefghijklmnopqrstuvwxyz0123

The unique ID of the user whose statistics you wish to retrieve.

time integer
86400

The time period in seconds to filter the transactions.
Optional. Defaults to 24 hours (86400 seconds).

Response JSON

status string required

Indicates the result of the API request.
For more details about error handling, check here.

currency string required

The currency in which the stats are reported.
Can be configured here.

revenue decimal required
1500.25

The total revenue in the user's currency over the selected time period.

revenue_change decimal required
15.5

The percentage change in revenue compared to the previous period.

transaction_count integer required
500

The total number of transactions in the user's account over the selected time period.

transaction_count_change decimal required
10

The percentage change in the transaction count compared to the previous period.

completion_rate decimal required
80.5

The percentage of transactions marked as completed over the selected time period.

completion_rate_change decimal required
5.3

The percentage change in the completion rate compared to the previous period.

GET POST

/user/exchange

Perform an exchange from one currency to another for a user.
This endpoint allows users to exchange a specified amount of currency they hold for another currency based on the current exchange rate.

Query Params / Form Data

key string required
abcdefghijklmnopqrstuvwxyz0123

Contains your API key.
Get it from here.

user_id string required
abcdefghijklmnopqrstuvwxyz0123

The unique ID of the user performing the exchange.

currency_from string required

The currency the user is exchanging from.

currency_to string required

The currency the user is exchanging to.

currency_from_amount decimal required
100.0

The amount of the source currency (currency_from) the user wants to exchange.

Response JSON

status string required

Indicates the result of the API request.
For more details about error handling, check here.

exchange_id string required
abcdefghijklmnopqrstuvwxyz0123

The unique identifier for the exchange transaction.

GET POST

/user/withdraw

Withdraw an amount of a specific currency to a designated recipient address.
This endpoint allows users to withdraw their funds to an external crypto address.

Query Params / Form Data

key string required
abcdefghijklmnopqrstuvwxyz0123

Contains your API key.
Get it from here.

user_id string required
abcdefghijklmnopqrstuvwxyz0123

The unique ID of the user requesting the withdrawal.

currency string required

The currency the user wishes to withdraw.

amount decimal required
0.5

The amount of the currency to be withdrawn.
This is the amount before any withdrawal fees are applied.

recipient string required
1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

The recipient's crypto address where the funds will be sent.

Response JSON

status string required

Indicates the result of the API request.
For more details about error handling, check here.

exchange_id string required
abcdefghijklmnopqrstuvwxyz0123

The unique identifier for the withdrawal transaction.

GET POST

/user/changesettings

Change various user settings such as username, currency, password, and other details.
This endpoint allows the user to update settings like their username, currency, password, store name, terms of service, privacy policy, logo, banner, theme color, and payment methods.

Query Params / Form Data

key string required
abcdefghijklmnopqrstuvwxyz0123

Your API key.
Get it from here.

user_id string required
abcdefghijklmnopqrstuvwxyz0123

The unique ID of the user whose settings are being updated.

username string
new_username

The new username for the user.

currency string

The new currency for the user.

update_key boolean
True

Whether to generate a new API key for the user.

password string
new_password

The new password for the user.

confirm_password string
new_password

The password confirmation.

storename string
new_store_name

The new store name for the user.

terms_of_service string
https://example.com/terms

The URL for the updated terms of service.

privacy_policy string
https://example.com/privacy

The URL for the updated privacy policy.

logo base64 string
base64encodedstring

The base64-encoded image for the user's logo.

theme_color hex color
FFFFFF

The new theme color for the user.

payment_methods JSON object
{"btc": {"status": "enabled"}}

A JSON object representing the user's payment methods and their statuses.

Response JSON

status string required

Indicates the result of the API request.
For more details about error handling, check here.

data array
{"new_key": "new_api_key_string"}

Contains additional data related to the update.
For example, if the API key is updated, this field may contain the new key.