ShapeBTC — Simple Crypto Exchange at the Best Price

API

Контакт: shapebtc.com

Описание ресурсов официального API shapebtc.com v1 (частично). Если у вас возникли вопросы или запросы, обратитесь в support.

Весь доступ к API осуществляется по HTTPS с адреса https://shapebtc.com/api/v1.

Передаваемые данные должны быть в формате JSON с кодировкой UTF-8. Для успешных API-запросов каждый запрос должен содержать несколько обязательных заголовков:

 

  • Заголовок Content-Type должен иметь значение application/json; charset=UTF-8
  • Заголовок X-API-KEY должен содержать ваш полученный API-ключ (YOUR_API_KEY)

cURL -X GET \
-H "Accept: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json; charset=UTF-8" \
-d 'DATA_JSON'
"https://shapebtc.com/api/METHOD"

/v1/price
Успешный ответ содержит информацию о курсе обмена для выбранной валютной пары.

 

Server URL

https://shapebtc.com/api/v1/price
Примеры ответов

{

  • "rate": 42010.12,
  • "withdrawalFee": "1 USDTTRC20",
  • "result": true

}

{

  • "status": 401,
  • "message": "Unauthorized"

}

Параметры
fromCcy
string Example: "BTC" Код валюты, которую клиент хочет отправить
toCcy
string Example: "USDTTRC20" Код валюты, которую клиент хочет получить
amount
number Example: 1 Сумма в валюте fromCcy, которую клиент хочет отправить
type
string Example: "float" Допустимые значения: "float" "fixed" Тип ордера
Responses
rate
float
withdrawalFee
float
result
bool
status
integer
message
string Required
Примеры ответов

{

  • "BTC": {
    • "coinName": "Bitcoin",
    • "minamount": 0.01,
    • "maxamount": 101,
    • "tagname": "",
    • "network": "Bitcoin",
    • "available": true
    },
  • "ETH": {
    • "coinName": "Ethereum",
    • "minamount": 0.9,
    • "maxamount": 1702,
    • "tagname": "",
    • "network": "erc20",
    • "available": true
    }

}

{

  • "status": 401,
  • "message": "Unauthorized"

}

Responses
status
integer
message
string Required

Возвращает все доступные валютные пары для обмена.

Примеры ответов

{

  • "BTC": [
    • "ETH",
    • "USDTTRC20",
    • "XMR"
    ],
  • "USDTTRC20": [
    • "BTC",
    • "XMR",
    • "TRX",
    • "ETH"
    ]

}

{

  • "status": 401,
  • "message": "Unauthorized"

}

Responses
status
integer
message
string Required

Создаёт заявку на обмен выбранных валют с указанной суммой и адресом получателя.

Примеры ответов

{

  • "id": "khvu65c1f334e621f",
  • "depositAddress": "bc1qjnyas2ndcyxrf932k1mpm49pyrtuytgd2zwlw8",
  • "depositTag": "",
  • "result": "true"

}

{

  • "status": 401,
  • "message": "Unauthorized"

}

Параметры
fromCcy
string Example: "BTC" Код валюты, которую клиент хочет отправить
toCcy
string Example: "USDTTRC20" Код валюты, которую клиент хочет получить
amount
number Example: 1 Сумма в валюте fromCcy, которую клиент хочет отправить
type
string Example: "float" Допустимые значения: "float" "fixed" Тип ордера
toAddress
string Example: "TNPdqto8HiuMzoG7Vv9wyyYhWzCojLeHAF" Адрес получателя, на который будут отправлены средства после успешного завершения заявки.
Responses
id
string Идентификатор ордера
depositAddress
string Адрес депозита, на который пользователь должен перечислить средства для выполнения обмена
depositTag
number MEMO или Destination Tag, если требуется
result
boolean
status
integer
message
string Required

Получить детали ордера

Примеры ответов

{

  • "status": "deposit_received",
  • "fromCcy": "BTC",
  • "toCcy": "USDTTRC20",
  • "depositAddress": "bc1qjnyas2ndcyxrf932k1mpm49pyrtuytgd2zwlw8",
  • "depositTag": "",
  • "destinationAddress": "TNPdqto8HiuMzoG7Vv9wyyYhWzCojLeHAF",
  • "destinationTag": "",
  • "expectedAmountFrom": "1",
  • "expectedAmountTo": "42020.15",
  • "amountFrom": "0.5",
  • "date": "01.01.2024 10:15:03",
  • "txId": null,
  • "amountTo": null,
  • "result": true

}

{

  • "status": 401,
  • "message": "Unauthorized"

}

Параметры
id
string Идентификатор ордера
Responses
status
string Статус ордера. Может принимать одно из значений:
  • new — новый обмен
  • waiting_deposit — ожидание депозита
  • deposit_received — депозит получен
  • exchanging — в процессе обмена
  • sending — в процессе отправки
  • success — обмен завершён успешно
  • time_expired — истекло время ожидания средств
  • failed — обмен завершился с ошибкой
  • sending_failed — попытка отправки не удалась
  • reverted — средства возвращены клиенту
fromCcy
string
toCcy
string
depositAddress
string Адрес депозита, на который пользователь должен перечислить средства для выполнения обмена
depositTag
string MEMO или Destination Tag, если требуется
destinationAddress
string Адрес назначения, на который будут отправлены средства после успешного завершения ордера
destinationTag
string MEMO или Destination Tag, если требуется
expectedAmountFrom
number
expectedAmountTo
number
amountFrom
number
amountTo
< anything >
date
string
txId
string
result
boolean
status
integer
message
string Required