Swap/LP Quest Verification API

For Ecosystem Partners

When ecosystem partners want to run campaigns on various platforms such as Galxe, Airlyft, Intract, they may face several technical challenges in adding quests related to their tokens. Understanding contract structures and performing direct indexing is cumbersome and costly. To help ecosystem partners proceed with this easily, we have prepared verification APIs in advance. Feel free to add quests related to Swap and LP by adjusting parameters.

*Rate limits are applied to prevent resource waste when used on non-whitelisted platforms. For detailed usage instructions, please contact the Kyo team through Telegram or Discord ticket.

**Parameters marked with '?' are all optional. For example, when you don't want to set minOutputAmount, instead of adding the parameter as 0, you can simply omit it entirely.

** ’updatedAt’ indicates the last time the user completed the quest

**CHAIN_ID for Soneium mainnet is 1868

1. Swap Quest

Depending on the quest, you can specify the From/To token, minimum output amount, and quest start time.

[Swap]
GET https://v2-api.kyo.finance/external-quest/swap/{CHAIN_ID}

queryParams: {
  address: string; // user address
  outputToken?: string; // output token address
  inputToken?: string; // input token address
  minOutputAmount?: string; // minimum output amount
  fromTs?: string; // unix timestamp(second)
  minVolumeUSD?: string; // minimum usd volume
}
response: {
  verified: boolean;
  updatedAt: number;
  data: { 
    txHash: string | null; 
  }
}

Example:

1) Verify whether the user has any token swaps with volumes exceeding $10. Only count transactions that occurred after Unix timestamp 173987124.

⇒ https://v2-api.kyo.finance/external-quest/swap/1868?address=$address&minVolumeUSD=10&fromTs=1739873124

Example quest setting on Galxe

2) Verify that user has exchanged ETH for at least 10 USDC using the WETH->...->USDC path.

⇒ GET https://v2-api.kyo.finance/external-quest/swap/1868?address={userAddress}&inputToken=0x4200000000000000000000000000000000000006&outputToken=0xbA9986D2381edf1DA03B0B9c1f8b00dc4AacC369&minOutputAmount=10000000

2. LP Quest

You may want to verify multiple LP quests rather than just one. For example, you might want to give an OK if someone has deposited in any of these pools: ETH-USDC V3 0.3%, ETH-USDC V3 0.05%, or ETH-USDC V2. Therefore, these are accepted as a list. You can set minimum USD values for each pool.

[Lp]
GET https://v2-api.kyo.finance/external-quest/lp/{CHAIN_ID}

queryParams: {
  address: string; // user address
  poolAddresses: string[]; // pool address list
  minUSDValues?: string[]; // minimum USD value list. Must be the same length and pool order as the poolAddresses argument
}
response: {
  verified: boolean; // will be true if any of the poolAddresses passes verification
  updatedAt: number;
  data: { 
    [poolAddress: string]: {
      verified: boolean; // verification results for each pools
      usdValue: string;
    }; 
  }
}

Example:

Verify that user has deposited at least $100 in the V3 ETH-USDC lp or V2 ETH-USDC lp.

GET https://v2-api.kyo.finance/external-quest/lp/1868?address={userAddress}&poolAddresses[]=0x9fcca0a1af56d34c88156e8857a5f430db7a6382&poolAddresses[]=0x7a45ab555aff1f658e4e24ea91ee90b13717f2f6&minUSDValues[]=100&minUSDValues[]=100