CIAN
cian.app
  • 📒A brief intro to CIAN
  • cian.app
  • ▶️Getting Started with Cian
    • CIAN Yield Layer Page Overview
    • Yield Layer
      • Introduction
        • CIAN Yield Layer Tech Docs
        • CIAN Yield Layer Points API
        • Chainlink Oracles
      • Yield Sources of ETH-Related Yield Layer
      • stETH Yield Layer
      • fBTC Yield Layer
      • slisBNB Yield Layer
    • Eco. Earn Vault
      • Sonic Vault
      • Berachain Pre-Deposit Vault
      • Passive Bera NFT
    • Strategy Vault
      • weETH RR Strategy Vault
      • wstETH RS Strategy Vault
    • Automated Strategies
      • Setup your account
        • Create smart contract wallet
        • Gas contract + EIP
      • FAQs
      • RS Strategies
        • sAVAX/AVAX Recursive Staking (8x)
        • MaticX/Matic Recursive Staking (6x)
      • Security
    • Fees
    • Referral System
  • 🔱Ambassador Program
    • Join the CIAN Ambassador Program!
  • 📌Point System
    • CIAN Voyage Points
    • Yield Racer
  • 🪙Tokenomics
    • Token
  • 🔰Security and Risk
    • Risk Warning
    • Audit Report
  • Term of Use
  • 🔍RESOURCES
    • Contracts
      • Yield Layer
      • Eco.Earn Vault
      • Berachain Pre-Deposit Vault
      • Avalanche
      • Polygon
    • Contact us
    • Discord
    • X (prev. Twitter)
    • Telegram (community)
    • Telegram (announcement)
    • Medium
    • Youtube
Powered by GitBook
On this page
  • Introduction
  • Query Methods
  • Method 1: Fixed Interval Points Query
  • Method 2: Timestamp-Based Points Query
  • Additional

Was this helpful?

  1. Getting Started with Cian
  2. Yield Layer
  3. Introduction

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.

PreviousCIAN Yield Layer Tech DocsNextChainlink Oracles

Last updated 3 months ago

Was this helpful?

▶️