Public

System status GET

Returns simple answer {"status":"OK"}.

Endpoint

GET https://switchere.com/api/v2/partner/healthcheck

Response

{
    status: "OK"
}
NameTypeDescription
statusstringSystem status.

Available currencies GET

Return data about partner payin->payout currencies.

Endpoint

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

Response

{
    "...": [
        "...",
        "...",
        "..."
    ]
}
NameTypeDescription
...dict of arraysPayin currency -> [ Payout currencies for this Payin currency ].

Available payment methods GET

Return data about partner payments.

Endpoint

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

Parameters

NameTypeDescription
directionName requireddirectionName of direction.

Response

[
    {
        "group": "card",
        "info": "USD, EUR",
        "list": [
            {
            "currency": "USD",
            "is_crypto": false
            }
        ],
        "title": "Credit/Debit Card"
    }
]
NameTypeDescription
grouppaymentGroupPayment group.
infostringInfo about group.
listarrayArray objects contain: currency and is_crypto.
titlestringTitle for group.

Tip: Field parameters info

Country list GET

Return data about all available countries on Switchere.

Endpoint

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

Response

[
    {
        "code": "AF",
        "forbidden": 0,
        "forbidden_card": 0,
        "name": "Afghanistan",
    },
    {
        "code": "AL",
        "forbidden": 0,
        "forbidden_card": 0,
        "name": "Albania",
    },
    ...
]
NameTypeDescription
codecountry codeCountry code.
forbiddenboolIf the value is set to 1, Switchere doesn't support this country.
forbidden_cardboolIf the value is set to 1, Switchere doesn't support the use of the bank card for this country.
namestringCountry name.

Allowed countries by method GET

Return data about allowed countries for payout method.

Endpoint

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

Parameters

NameTypeDescription
methodName requiredstringExample: ecommpay
Name of payout method.
directionName requireddirectionName of direction.

Response

[
    "AD",
    "AE",
    "AF",
    "..."
]
NameTypeDescription
...arrayArray of countries.

Tip: Field parameters info

Ticker list GET

Return data about partner rates.

Endpoint

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

Response

[
    {
        "ask": "21187.44",
        "bid": "20364.70",
        "floating_rate": "20752.5",
        "name": "BTC-USD"
    }
]
NameTypeDescription
namestringPair name.
askfloatAsk rate.
bidfloatBid rate.
floating_ratefloatFloating rate.

Ticker GET

Return data about partner rate.

Endpoint

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

Parameters

NameTypeDescription
tickerName requiredstringExample: BTC-USD
Name of rate.

Response

{
    "ask": "21187.44",
    "bid": "20364.70",
    "floating_rate": "20752.5",
    "name": "BTC-USD"
}
NameTypeDescription
namestringPair name.
askfloatAsk rate.
bidfloatBid rate.
floating_ratefloatFloating rate.

Order fee POST

Return data about fee for order.

Endpoint

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

Parameters

NameTypeDescription
partner_order_id requiredstringunique partner order id
payin_currency requiredcurrencypayin currency
payin_amountfloatpayin amount. One of payin_amount, payout_amount is required.
payin_grouppaymentGroupif empty, will be choosen first available method for payin currency. See order in enum.
payout_currency requiredcurrencypayout currency
payout_amountfloatpayout amount. One of payin_amount, payout_amount is required.
payout_grouppaymentGroupif empty, will be choosen first available method for payout currency. See order in enum.
is_floating_rateinteger[0..1]Calculate order fee with or without floating rate. By default is_floating_rate = 0.

Response

{
    "payin_amount": "string",
    "payout_amount": "string",
    "rate": "string",
    "payin_fee": "string",
    "payout_fee": "string",
    "margin_fee": "string"
}
NameTypeDescription
payin_amountstringpayin currency
payout_amountstringpayout amount
ratestringrate payin_currency/payout_currency
payin_feestringnetwork fee in payin currency
payout_feestringnetwork fee in payout currency
margin_feestringservice fee in payin currency

Tip: Field parameters info



TIP

Also see field parameters

Last Updated: