Public API

Order fee POST

Return data about fee for order.

Endpoint

POST https://switchere.com/api/v1/public/order/fee

Parameters

Name	Type	Description
partner_order_id required	string	unique partner order id
payin_currency required	currency	payin currency
payin_amount	float	payin amount. One of payin_amount, payout_amount is required.
payin_group	paymentGroup	if empty, will be choosen first available method for payin currency. See order in enum.
payout_currency required	currency	payout currency
payout_amount	float	payout amount. One of payin_amount, payout_amount is required.
payout_group	paymentGroup	if empty, will be choosen first available method for payout currency. See order in enum.
free_first	integer[0..1]	enable or disable free first order policy. By default free_first = 1

Response

{
    "payin_amount": "string",
    "payout_amount": "string",
    "rate": "string",
    "payin_fee": "string",
    "payout_fee": "string",
    "margin_fee": "string"
}

Name	Type	Description
payin_amount	string	payin currency
payout_amount	string	payout amount
rate	string	rate payin_currency/payout_currency
payin_fee	string	network fee in payin currency
payout_fee	string	network fee in payout currency
margin_fee	string	service fee in payin currency

Tip: Field parameters info

• currency
• paymentGroup

Currencies GET

Return data about partner payin->payout currencies.

Endpoint

GET https://switchere.com/api/v1/public/currency

Response

{
    "...": [
        "...",
        "...",
        "..."
    ]
}

Name	Type	Description
...	array	payout currencies

Payments GET

Return data about partner payments.

Endpoint

GET https://switchere.com/api/v1/public/payment/{directionName}

Parameters

Name	Type	Description
directionName required	direction	Name of direction.

Response

[
    {
        "group": "card",
        "info": "USD, EUR",
        "list": [
            {
            "currency": "USD",
            "is_crypto": true
            }
        ],
        "title": "Credit/Debit Card"
    }
]

Name	Type	Description
group	paymentGroup	payment group
info	string	info for group
list	array	array objects contain: currency and is_crypto
title	string	title for group

Tip: Field parameters info

• direction
• paymentGroup

Country list GET

Return data about all available countries on Switchere.

Endpoint

GET https://switchere.com/api/v1/public/country/list

Response

[
    {
        "code": "AF",
        "forbidden": 0,
        "forbidden_card": 0,
        "name": "Afghanistan",
    },
    {
        "code": "AL",
        "forbidden": 0,
        "forbidden_card": 0,
        "name": "Albania",
    },
    ...
]

Name	Type	Description
code	string	country code
forbidden	integer[0..1]	if the value is set to 1, Switchere doesn't support this country
forbidden_card	integer[0..1]	if the value is set to 1, Switchere doesn't support the use of the bank card for this country
name	string	country name

Countries GET

Return data about allowed countries for payout method.

Endpoint

GET https://switchere.com/api/v1/public/country/{methodName}/{directionName}

Parameters

Name	Type	Description
methodName required	string	Example: ecommpay Name of payout method.
directionName required	direction	Name of direction.

Response

[
    "AD",
    "AE",
    "AF",
    "..."
]

Name	Type	Description
...	array	array of countries

Tip: Field parameters info

• direction

Tickers GET

Return data about partner rates.

Endpoint

GET https://switchere.com/api/v1/public/ticker

Response

[
    {
        "name": "BTC-USD",
        "ask": 100.01,
        "bid": 99.9
    }
]

Name	Type	Description
name	string	pair name
ask	string	ask
bid	string	bid

Ticker GET

Return data about partner rate.

Endpoint

GET https://switchere.com/api/v1/public/ticker/{tickerName}

Parameters

Name	Type	Description
tickerName required	string	Example: BTC-USD Name of rate.

Response

{
    "name": "BTC-USD",
    "ask": 100.01,
    "bid": 99.9
}

Name	Type	Description
name	string	pair name
ask	string	ask
bid	string	bid

TIP

Also see field parameters.