August 21, 2023

CodeChange API

Supported Currency List

Get the list of supported currencies, and their supported networks {GET}

https://api.codechange.cc/currencyList

Header

Field - API-KEY
Type - String
Description - Your API key

Parameter

Field - currency
Type - String
Description - If the currency is not set, details for all currencies will be returned

Request Example

curl -X GET 'https://api.codechange.cc/currencyList' -H 'API-KEY: your_api_key'

Successful Response

HTTP/1.1 200 OK
{
    "success": 1,
    "data": [{
        "currency": "BTC",
        "name": "Bitcoin",
        "sendStatusAll": true,
        "receiveStatusAll": false,
        "networkList": [{
            "network": "BNB",
            "name": "BEP2",
            "isDefault": false,
            "sendStatus": true,
            "receiveStatus": false,
            "receiveDecimals": 8,
            "confirmationsMinimum": 1,
            "confirmationsMaximum": 1,
            "explorer": "https://explorer.binance.org/",
            "explorerHash": "https://explorer.binance.org/tx/{{txid}}",
            "explorerAddress": "https://explorer.binance.org/address/{{addr}}",
            "hasTag": true,
            "tagName": "MEMO",
            "contractAddress": "BTCB-1DE",
            "contractAddressUrl": "https://binance.mintscan.io/assets/"
        },
        {
            "network": "BTC",
            "name": "BTC",
            "isDefault": ture,
            "sendStatus": true,
            "receiveStatus": true,
            "receiveDecimals": 8,
            "confirmationsMinimum": 1,
            "confirmationsMaximum": 2,
            "explorer": "https://www.blockchain.com/explorer/",
            "explorerHash": "https://www.blockchain.com/btc/tx/{{txid}}",
            "explorerAddress": "https://www.blockchain.com/btc/address/{{addr}}",
            "hasTag": false
        },
        {
            . . .
        }]
    },
    {
        "currency": "ETH",
        "name": "Ethereum",
        "sendStatusAll": true,
        "receiveStatusAll": true,
        "networkList": [{
            . . .
        }]
    },
    {
        . . .
    }]
}

Pair Information

Get exchange information for a pair of currencies - networks {GET}

https://api.codechange.cc/pairInfo

Header

Field - API-KEY
Type - String
Description - Your API key

Parameter

Field Type Description

send String Ticker of currency to send

receive String Ticker of currency to receive

sendNetwork String Ticker of network to send. Default network will be selected if omitted

receiveNetwork String Ticker of network to receive. Default network will be selected if omitted

Request Example

curl -X GET 'https://api.codechange.cc/pairInfo?send=ETH&receive=BTC&sendNetwork=BNB&receiveNetwork=BSC' -H 'API-KEY: your_api_key'

Successful Response

HTTP/1.1 200 OK
{
    "success": 1,
    "data": {
        "minimumAmount": "0.01075",
        "maximumAmount": "420",
        "networkFee": "0.000005",
        "confirmations": 1,
        "processingTime": "3-5"
    }
}


Exchange Rate

The exchange rate for the requested pair is returned {GET}

https://api.codechange.cc/rate

Header

Field - API-KEY
Type - String
Description - Your API key

Parameter

Field Type DescriptionsendString

send String Ticker of currency to send

receive String Ticker of currency to receive

amount Float Amount to send

sendNetwork String Ticker of network to send. Default network will be selected if omitted

receiveNetwork String Ticker of network to receive. Default network will be selected if omitted

amountType String Set this parameter as "receive" if you want to specify as "amount" the receive amount

Request Example

curl -X GET 'https://api.codechange.cc/rate?send=ETH&receive=BTC&sendNetwork=BNB&receiveNetwork=BSC&amount=0.1' -H 'API-KEY: your_api_key'

Successful Response

HTTP/1.1 200 OK
{
    "success": 1,
    "data": {
        "rate": "0.08195835",
        "sendAmount": "0.1",
        "receiveAmount": "0.00819083",
        "networkFee": "0.000005",
        "confirmations": 1,
        "processingTime": "3-5"
    }
}


Validate Address

Validate wallet address and tag for specified coin - network {GET}

https://api.codechange.cc/validateAddress

Header

Field - API-KEY
Type - String
Description - Your API key

Parameter

Field Type Description

currency String Ticker of currency to validate

address String The wallet address you want to validate

network String Ticker of network to validate. Default network will be selected if omitted

tag String The wallet tag you want to validate

Request Example

curl -X GET 'https://api.codechange.cc/validateAddress?currency=BTC&address=0xeB2629a2734e272Bcc07BDA959863f316F4bD4Cf&network=BSC' -H 'API-KEY: your_api_key'


Successful Response

HTTP/1.1 200 OK
{
    "success": 1,
    "data": {
        "address": "0xeB2629a2734e272Bcc07BDA959863f316F4bD4Cf"
    }
}


Risk Evaluation

User Device Id

You should generate a unique user device identifier by following the best practices and standards for generating unique user identifiers. The identifier must be unique per user and device and must be consistent between orders placed by the same user device.

When creating an order, you must record the client's IP address and store this information for 5 years and provide it to us upon request.

Place Order

POST

https://api.codechange.cc/order

Header

Field - API-KEY
Type - String
Description - Your API key

Parameter

Field Type Description

send String Ticker of currency to send

receive String Ticker of currency to receive

amount Float The amount you have to send

receiveAddress String Receive wallet address

userDeviceId String A unique user device identifier generated on your end, represents a user device. Should be unique per user and device, orders placed from the same user device should contain the same userDeviceId. (Required when payload is not set, Optional when payload is set)

sendNetwork String Ticker of network to send. Default network will be selected if omitted

receiveNetwork String Ticker of network to receive. Default network will be selected if omitted

receiveTag String Receive wallet address tag

amountType String Set this parameter as "receive" if you want to specify as "amount" the receive amount

Request JSON Body Example

{
    "send": "BTC",
    "receive": "ETH",
    "amount": "0.123",
    "receiveAddress": "0xeB2629a2734e272Bcc07BDA959863f316F4bD4Cf",
    "userDeviceId": "xxxxxxxx"
}

Request Example

curl -X POST 'https://api.codechange.cc/order' -H 'API-KEY: your_api_key' -H "Content-type: application/json" -d '{"send":"BTC","receive":"ETH","amount":"0.123","receiveAddress":"0xeB2629a2734e272Bcc07BDA959863f316F4bD4Cf","userDeviceId":"xxxxxxxx"}'

Successful Response

HTTP/1.1 200 OK
{
    "success": 1,
    "data": {
        "id": "I1Y0EFP31Rwu",
        "send": "BTC",
        "receive": "ETH",
        "sendNetwork": "BTC",
        "receiveNetwork": "ETH",
        "sendAmount": "0.123",
        "receiveAmount": "1.73703678",
        "sendAddress": "1NiwKhcuV4Xrep5gnki4enFBBRH6hHuKzf",
        "sendTag": null,
        "receiveAddress": "0xeB2629a2734e272Bcc07BDA959863f316F4bD4Cf",
        "receiveTag": null,
        "refundAddress": null,
        "refundTag": null,
        "vpm": "off",
        "createdAt": 1643036313520
    }
}


Order Status

Get your order status {GET}

https://api.codechange.cc/orderStatus

Header

Field - API-KEY
Type - String
Description - Your API key

Parameter

Field Type Description

id String Order id

Request Example

curl -X GET 'https://api.codechange.cc/orderStatus?id=I1Y0EFP31Rwu' -H 'API-KEY: your_api_key'

Successful Response

status - "Awaiting Deposit" or "Confirming Deposit" or "Exchanging" or "Sending" or "Complete" or "Refund" or "Failed" or "Action Request" or "Request Overdue"

validationLink - URL that should be displayed to the user on the order exchange page when the order status is "Action Request"


Successful Response

HTTP/1.1 200 OK
{
    "success": 1,
    "data": {
        "id": "I1Y0EFP31Rwu",
        "status": "Awaiting Deposit",
        "receiveAmount": "1.73703678",
        "hashIn": null,
        "hashOut": null,
        "validationLink": null,
        "createdAt": 1643036313520,
        "updatedAt": 1643036313520
    }
}

Orders

Get your orders {GET}

https://api.codechange.cc/orders

Header

Field - API-KEY
Type - String
Description - Your API key

Parameter

Field Type Description

id String Order id

Successful Response

HTTP/1.1 200 OK
{
    "success": 1,
    "data": [{
        "id": "I1Y0EFP31Rwu",
        "send": "BTC",
        "receive": "ETH",
        "sendNetwork": "BTC",
        "receiveNetwork": "ETH",
        "sendAmount": "0.123",
        "profit": "11.22",
        "estimatedReceiveAmount": "1.73703678",
        "receiveAmount": "1.73703678",
        "sendAddress": "1NiwKhcuV4Xrep5gnki4enFBBRH6hHuKzf",
        "sendTag": null,
        "receiveAddress": "0xeB2629a2734e272Bcc07BDA959863f316F4bD4Cf",
        "receiveTag": null,
        "refundAddress": null,
        "refundTag": null,
        "vpm": "off",
        "status": "Awaiting Deposit",
        "hashIn": null,
        "hashOut": null,
        "networkFee": "0",
        "earned": "0",
        "validationLink": null,
        "createdAt": 1643036313520,
        "updatedAt": 1643036313520
    },
    {
        ...
    }]
}


Profit

According to the standard you will receive a profit of 60% for this you must provide all orders that were made using your service, in advance send orders only with the status of compliant, payment will be from 50$
To get the API key write @codechangeoff