CIAN Yield Layer Points API

Introduction

This API specification aims to enable DeFi projects to directly allocate points to this protocol’s address, eliminating the need to distribute points to individual users. By doing so, this protocol can better manage and unify the recording of points accumulation. Project teams must implement at least one of the two available query methods.

Query Methods

Method 1: Fixed Interval Points Query

Request Method

GET /points?address={address}

(just an example)

Request Parameters

Parameter	Type	Required	Description
address	string	Yes	User wallet address

Response Example

{
    "points": [
        { "timestamp": 1709251200, "points": 90 },
        { "timestamp": 1709337600, "points": 100 }
    ]
}

or if you have several points to distribute,

{
    "points": [
        { "timestamp": 1709251200, "points_A": 90, "points_B": 90 },
        { "timestamp": 1709337600, "points_A": 100, "points_B": 90 }
    ]
}

Description

The interval must be no longer than one day.

---

Method 2: Timestamp-Based Points Query

Request Method

GET /points?address={address}&timestamp={timestamp}

(just an example)

Request Parameters

Parameter	Type	Required	Description
address	string	Yes	User wallet address
timestamp	int	Yes	Query timestamp (in seconds)

Response Example

{
    "points": 120
}

Description

The responses should vary from different timestamps input.

Additional

• The detailed info is not necessary, only the total points are needed.