Over-the-counter Transaction Record V2

POST

platformapi

chainup

open

user

otcTradeRecord

curl --request POST \
--url http://service.xxx.com/platformapi/chainup/open/user/v2/otcTradeRecord

{
    "code": "0",
    "msg": "Success",
    "message": null,
    "data": [
        {
            "sidCid": 1006,
            "totalPrice": "1.0000000000000000",
            "payTime": null,
            "advert": {
            "id": 2020202,
            "userId": 20202022,
            "status": 1,
            "side": "SELL",
            "coin": "XFNH",
            "country": "",
            "paycoin": "CNY",
            "payment": "otc.payment.wxpay",
            "bankname": "",
            "priceRate": 0E-16,
            "priceRateType": 0,
            "price": 4.0000000000000000,
            "volume": 50.0000000000000000,
            "feeRate": 0.0100000000000000,
            "minTrade": 1.0000000000000000,
            "maxTrade": 2.0000000000000000,
            "beginDate": 1692115200000,
            "endDate": 1694707200000,
            "limitTime": 15,
            "terms": "",
            "description": "123",
            "authType": "",
            "minvolume": 0E-16,
            "sell": 0E-16,
            "beginTime": 60,
            "endTime": 86340,
            "ctime": 1692175383000,
            "personalFeeDiscount": 1.0000000000000000,
            "dealVolume": 0,
            "muid": 0,
            "mtime": -62107027200000,
            "autoReply": "zytest",
            "openType": "CUSTOM",
            "numberCode": "4",
            "companyId": 1006,
            "isBlockTrade": 0,
            "lastPrice": 0E-16,
            "initMaxTrade": 2.0000000000000000

        },
            "buyerId": 2222020,
            "adsOwner": 20202002,
            "adsId": 412506,
            "buyerComment": "",
            "sellerComment": "",
            "buyerCommentGrade": 0,
            "payCoin": "CNY",
            "volume": "0.250000000000",
            "bidCid": 1006,
            "sequence": "202308291576865",
            "feeAmount": null,
            "sellerCommnetGrade": 0,
            "coinSymbol": "XFNH",
            "sellerId": 23692107,
            "createTime": 1693279508000,
            "price": "4.0000000000000000",
            "id": 1576865,
            "status": 4,
            "isBlockTrade": 0
        }
    ]
}

Query Parameters

appKey

string

required

Merchant AppKey

Example: xxx_xxx

openId

string

openId, userId must pass one, while passing, take openId

userId

string

openId, userId must pass one, while passing, take openId

mobileNumber

string

Cell phone number

Example: 09011223

string

User email(openId,userId,mobileNumber,email)Four choices are required.

Example: xxx@xxx.com

page

string

Default= 1 .

Example: 1

pageNumber

string

Default 1000 entries.

Example: 1000

sign

string

required

Signature

Example: 2ae04ed9165624419bad68e9e0f3f2sa9fbd2ae04ed916511624419bad68e9e20f3f29fbd

startTime

string

Start time

Example: 1690879504000

endTime

string

End time

Example: 1690879504000

Response

200 - application/json

code

string

Return code.

Example: 0

msg

string

Success or failure message

Example: Success

message

string

Message

Example: null

data

object

data.sidCid

string

Seller's merchant ID

Example: 24093315

data.totalPrice

string

Total advertising price

Example: 200

data.payTime

string

Pay time

Example: 66071485.41974519

data.advert

object[]

data.advert.id

string

Ad's ID

Example: xxx

data.advert.userId

string

User's ID

Example: xxx

data.advert.status

string

Ad Status 1 Posting 2 Trading 3 Expired 4 Closed

Example: 2

data.advert.side

string

Transaction type

data.advert.coin

string

Trading currency (virtual currency)

data.advert.country

string

Country

Example: Singapore

data.advert.paycoin

string

Payment currency (fiat currency)

data.advert.payment

string

Payment method

data.advert.bankname

string

Bank name

data.advert.priceRate

string

Ratio of transaction price to market price

data.advert.priceRateType

string

Type of ratio of trading price to market price 1 is the same as market price 2 is higher than 3 is lower than.

data.advert.price

string

Price

Example: 20

data.advert.volume

string

Quantity

Example: 1

data.advert.feeRate

string

Rates

data.advert.minTrade

string

Minimum single transaction amount (amount)

data.advert.maxTrade

string

Maximum single transaction amount (amount)

data.advert.beginDate

string

Start date

data.advert.endDate

string

End date

data.advert.limitTime

string

Trading period

data.advert.terms

string

Trading terms

Example: in

data.advert.description

string

Payment information

data.advert.authType

string

Authentication method

data.advert.minvolume

string

Cumulative minimum trading volume

data.advert.sell

string

Actual number of current ads sold

data.advert.beginTime

string

Start time of ad display per day

data.advert.endTime

string

Deadline for ads to be displayed daily

data.advert.ctime

string

Creation date

data.advert.personalFeeDiscount

string

Personal handling fee discount, 1 means no discount

data.advert.dealVolume

string

data.advert.muid

string

Last Updated by who

data.advert.mtime

string

Last Updated by which time

data.advert.autoReply

string

Auto-reply messages

data.advert.openType

string

The advertising open way DEFAULT: system default time 30 days at any time visible, CUSTOM: user specified time period visible.

data.advert.numberCode

string

National digital

data.advert.companyId

string

Merchant id, 0 means SAAS total platform

data.advert.isBlockTrade

string

Whether bulk trading.

data.advert.lastPrice

string

Last price.

Example: 0E-16

data.advert.initMaxTrade

string

WExample: 2.0000000000000000

data.buyerId

string

Buy and sell type BUY buy SELL sell.

Example: 2222020

data.adsOwner

string

Ad owner's id

Example: 20202002

data.adsId

string

Ad ID

Example: 412506

data.buyerComment

string

Comments to the buyer

data.sellerComment

string

Comments to the seller

data.buyerCommentGrade

string

Comments to the buyer level 0 positive comments 1 bad comments default positive comments.

data.payCoin

string

Payment Currency

Example: CNY

data.volume

string

Number of Ads

Example: 0.250000000000

data.bidCid

string

Buyer Merchant id

data.sequence

string

OTC Order Number

data.feeAmount

string

Handling fee amount

data.sellerCommnetGrade

string

Review rating for the seller 0 positive comments 1 bad comments.

Example: 0

data.coinSymbol

string

Trading currency

Example: XFNH

data.sellerId

string

Seller'S uid

Example: 23692107

data.createTime

string

Creation time

Example: 1693279508000

data.price

string

Price

Example: 4.0000000000000000

data.id

string

Example: 1576865

data.status

string

Advertising transaction status Order status Pending payment 1 Paid 2 Transaction successful 3 Cancellation 4 Appeal 5 Coin hit 6 Abnormal order 7.

Example: 1

data.isBlockTrade

string

Whether bulk transaction, 0: Ordinary transaction, 1: Bulk transaction.

Example: 0

Over-the-counter Transaction Record V1 OTC Fee Sharing Record

curl --request POST \
--url http://service.xxx.com/platformapi/chainup/open/user/v2/otcTradeRecord

{
    "code": "0",
    "msg": "Success",
    "message": null,
    "data": [
        {
            "sidCid": 1006,
            "totalPrice": "1.0000000000000000",
            "payTime": null,
            "advert": {
            "id": 2020202,
            "userId": 20202022,
            "status": 1,
            "side": "SELL",
            "coin": "XFNH",
            "country": "",
            "paycoin": "CNY",
            "payment": "otc.payment.wxpay",
            "bankname": "",
            "priceRate": 0E-16,
            "priceRateType": 0,
            "price": 4.0000000000000000,
            "volume": 50.0000000000000000,
            "feeRate": 0.0100000000000000,
            "minTrade": 1.0000000000000000,
            "maxTrade": 2.0000000000000000,
            "beginDate": 1692115200000,
            "endDate": 1694707200000,
            "limitTime": 15,
            "terms": "",
            "description": "123",
            "authType": "",
            "minvolume": 0E-16,
            "sell": 0E-16,
            "beginTime": 60,
            "endTime": 86340,
            "ctime": 1692175383000,
            "personalFeeDiscount": 1.0000000000000000,
            "dealVolume": 0,
            "muid": 0,
            "mtime": -62107027200000,
            "autoReply": "zytest",
            "openType": "CUSTOM",
            "numberCode": "4",
            "companyId": 1006,
            "isBlockTrade": 0,
            "lastPrice": 0E-16,
            "initMaxTrade": 2.0000000000000000

        },
            "buyerId": 2222020,
            "adsOwner": 20202002,
            "adsId": 412506,
            "buyerComment": "",
            "sellerComment": "",
            "buyerCommentGrade": 0,
            "payCoin": "CNY",
            "volume": "0.250000000000",
            "bidCid": 1006,
            "sequence": "202308291576865",
            "feeAmount": null,
            "sellerCommnetGrade": 0,
            "coinSymbol": "XFNH",
            "sellerId": 23692107,
            "createTime": 1693279508000,
            "price": "4.0000000000000000",
            "id": 1576865,
            "status": 4,
            "isBlockTrade": 0
        }
    ]
}

API access instructions

API documentation

Over-the-counter Transaction Record V2

Query Parameters

Response