# ETHEREUM ORACLE
### Get NFT collection floor price
```
## Request
curl -X 'GET' \
'https://oracle-api.banksea.finance/nft/v1/eth/floor_price/current_status?collection=0x08D7C0242953446436F34b4C78Fe9da38c73668d&apikey=test-api-key' \
-H 'accept: application/json'
```
* Interface: /nft/v1/eth/floor\_price/current\_status
* Method: GET
* Data Format: JSON
* Request Parameter:
| Parameter | Type | Required | Description |
| ---------- | ------ | -------- | ------------------- |
| collection | String | Y | The NFT collection. |
| apikey | String | Y | apikey |
* Request Example:
```
https://oracle-api.banksea.finance/nft/v1/eth/floor_price/current_status?collection=0x08D7C0242953446436F34b4C78Fe9da38c73668d&apikey=test-api-key
```
* Response Data:
| Field | Type | Description |
| ------------ | ------ | ---------------- |
| floor\_price | Number | The floor price. |
| timestamp | Number | timestamp |
* Response Example:
```
{
"success": true,
"code": "200",
"message": "success",
"data": {
"timestamp": 1667741477,
"floor_price": 38.0000
}
}
```
### Make HTTP GET requests from smart contracts using Chainlink
To make HTTP GET requests from smart contract using Chainlink. Learn about how to connect API to Chainlink, please refer to [Chainlink Any API Documentation | Chainlink Documentation](https://docs.chain.link/any-api/introduction)
Get the reference code from our repo:
```
git clone https://github.com/Banksea-Finance/banksea-chainlink-api-demo
```
The request parameters of the reference code are fixed, you can modify the code according to your own requirements.
```
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.7;
import "@chainlink/contracts/src/v0.8/ChainlinkClient.sol";
import "@chainlink/contracts/src/v0.8/ConfirmedOwner.sol";
contract APIConsumer is ChainlinkClient, ConfirmedOwner {
using Chainlink for Chainlink.Request;
uint256 public floor;
bytes32 private jobId;
uint256 private fee;
event fillFloor(bytes32 indexed requestId, uint256 floor);
/**
* @notice Initialize the link token and target oracle
*
* Rinkeby Goerli details:
* Link Token: 0x326C977E6efc84E512bB9C30f76E30c160eD06FB
* Oracle: 0xCC79157eb46F5624204f47AB42b3906cAA40eaB7 (Chainlink DevRel)
* jobId: ca98366cc7314957b8c012c72f05aeeb
*
*/
constructor() ConfirmedOwner(msg.sender) {
setChainlinkToken(0x326C977E6efc84E512bB9C30f76E30c160eD06FB);
setChainlinkOracle(0xCC79157eb46F5624204f47AB42b3906cAA40eaB7);
jobId = "ca98366cc7314957b8c012c72f05aeeb";
fee = (1 * LINK_DIVISIBILITY) / 10; // 0,1 * 10**18 (Varies by network and job)
}
/**
* Create a Chainlink request to retrieve API response, find the target
* data, then multiply by 1000000000000000000 (to remove decimal places from data).
*/
function requestFloor() public returns (bytes32 requestId) {
Chainlink.Request memory req = buildChainlinkRequest(
jobId,
address(this),
this.fulfill.selector
);
// Set the URL to perform the GET request on
req.add(
"get",
"https://oracle-api.banksea.finance/nft/v1/eth/floor_price/current_status?collection=0x08D7C0242953446436F34b4C78Fe9da38c73668d&apikey=test-api-key"
);
req.add("path", "data,floor_price");
// Multiply the result by 1000000000000000000 to remove decimals
int256 timesAmount = 10 ** 18;
req.addInt("times", timesAmount);
// Sends the request
return sendChainlinkRequest(req, fee);
}
/**
* Receive the response in the form of uint256
*/
function fulfill(
bytes32 _requestId,
uint256 _floor
) public recordChainlinkFulfillment(_requestId) {
emit fillFloor(_requestId, _floor);
floor = _floor;
}
/**
* Allow withdraw of Link tokens from the contract
*/
function withdrawLink() public onlyOwner {
LinkTokenInterface link = LinkTokenInterface(chainlinkTokenAddress());
require(
link.transfer(msg.sender, link.balanceOf(address(this))),
"Unable to transfer"
);
}
}
```
Install dependencies:
```
npm install
```
Create a .env file, and fill it with the privatekey of your wallet and infura key:
```
PRIVATE_KEY=YOUR-PRIVATE-KEY
INFURA_KEY=YOUR-INFURA-KEY
```
Compile the contract:
```
npx hardhat compile
```
Deploy:
```
npx hardhat run .\scripts\deploy.ts --network goerli
```
Record the address of APIConsumer and fund some LINK to the address. You can call the **requestFloor** interface on the contract. After a while, you can check the **floor** value on it.
Refer to this contract on the Goerli testnet network:
```
https://goerli.etherscan.io/address/0x157afa2063741224ae22030d4fac9820a4c44bfc
```
### The list of supported NFT collections
| Name | Collection |
| ---------------------------------------- | ------------------------------------------ |
| The n project | 0x05a46f1E545526FB803FF974C790aCeA34D1f2D6 |
| PROOF Collective | 0x08D7C0242953446436F34b4C78Fe9da38c73668d |
| My Pet Hooligan | 0x09233d553058c2F42ba751C87816a8E9FaE7Ef10 |
| Robotos | 0x099689220846644F87D1137665CDED7BF3422747 |
| JRNY CLUB OFFICIAL | 0x0b4B2bA334f476C8F41bFe52A428D6891755554d |
| Kaiju Kingz | 0x0c2E57EFddbA8c768147D1fdF9176a0A6EBd5d83 |
| THE SHIBOSHIS | 0x11450058d796B02EB53e65374be59cFf65d3FE7f |
| alien frens | 0x123b30E25973FeCd8354dd5f41Cc45A3065eF88C |
| GalacticApes | 0x12d2D1beD91c24f878F37E66bd829Ce7197e4d14 |
| HYPEBEARSCLUB.OFFICIAL | 0x14e0a1F310E2B7E321c91f58847e98b8C802f6eF |
| PXN: Ghost Divison | 0x160C404B2b49CBC3240055CEaEE026df1e8497A0 |
| Moonbirds Oddities | 0x1792a96E5668ad7C167ab804a100ce42395Ce54D |
| DEGEN TOONZ COLLECTION | 0x19b86299c21505cdf59cE63740B240A9C822b5E4 |
| CryptoMories | 0x1a2F71468F656E97c2F86541E57189F59951efe7 |
| Cool Cats NFT | 0x1A92f7381B9F03921564a437210bB9396471050C |
| Treeverse | 0x1B829B926a14634d36625e60165c0770C09D02b2 |
| CrypToadz by GREMPLIN | 0x1CB1A5e65610AEFF2551A50f76a87a7d3fB649C6 |
| Sneaky Vampire Syndicate | 0x219B8aB790dECC32444a6600971c7C3718252539 |
| Moonbirds | 0x23581767a106ae21c074b2276D25e5C3e136a68b |
| Frontier Game | 0x236672Ed575E1e479b8E101AEeb920F32361f6F9 |
| V1 CryptoPunks Wrapped | 0x282BDD42f4eb70e7A9D9F40c8fEA0825B7f68C5D |
| DeadFellaz | 0x2acAb3DEa77832C09420663b0E1cB386031bA17B |
| BEANZ Official | 0x306b1ea3ecdf94aB739F1910bbda052Ed4A9f949 |
| Impostors Genesis Aliens | 0x3110EF5f612208724CA51F5761A69081809F03B7 |
| Pixelmon - Generation 1 | 0x32973908FaeE0Bf825A343000fE412ebE56F802A |
| Murakami.Flowers Seed | 0x341A1c534248966c4b6AFaD165B98DAED4B964ef |
| 888 inner circle | 0x36d30B3b85255473D27dd0F7fD8F35e36a9d6F06 |
| Quirkies Originals | 0x3903d4fFaAa700b62578a66e7a67Ba4cb67787f9 |
| The Potatoz | 0x39ee2c7b3cb80254225884ca001F57118C8f21B6 |
| 0N1Force | 0x3bf2922f4520a8BA0c2eFC3D2a1539678DaD5e9D |
| SupDucks | 0x3Fe1a4c1481c8351E91B64D5c398b159dE07cbc5 |
| Dooplicator | 0x466CFcD0525189b573E794F554b8A751279213Ac |
| Ragnarok Meta | 0x497a9A79e82e6fC0FF10a16f6F75e6fcd5aE65a8 |
| CLONE X - X TAKASHI MURAKAMI | 0x49cF6f5d44E70224e2E23fDcdd2C053F30aDA28B |
| Arcade Land | 0x4a8C9D751EEAbc5521A68FB080DD7E72E46462aF |
| MURI by Haus | 0x4B61413D4392c806E6d0fF5Ee91E6073C21d6430 |
| HAPE Prime | 0x4Db1f25D3d98600140dfc18dEb7515Be5Bd293Af |
| Forgotten Runes Wizards Cult | 0x521f9C7505005CFA19A8E5786a9c3c9c9F5e6f42 |
| CyberKongz | 0x57a204AA1042f6E66DD7730813f4024114d74f37 |
| Invisible Friends | 0x59468516a8259058baD1cA5F8f4BFF190d30E066 |
| Mutant Ape Yacht Club | 0x60E4d786628Fea6478F785A6d7e704777c86a7c6 |
| Space Doodles | 0x620b70123fB810F6C653DA7644b5dD0b6312e4D8 |
| We Are All Going to Die | 0x659A4BdaAaCc62d2bd9Cb18225D9C89b5B697A5A |
| Prime Ape Planet PAP | 0x6632a9d63E142F17a668064D41A21193b49B41a0 |
| PhantaBear | 0x67D9417C9C3c250f61A83C7e8658daC487B56B09 |
| NeoTokyo Outer Identities | 0x698FbAACA64944376e2CDC4CAD86eaa91362cF54 |
| Killer GF | 0x6bE69b2A9B153737887CfcdCa7781eD1511C7e36 |
| MetaHero Universe: Generative Identities | 0x6dc6001535e15b9def7b0f6A20a2111dFA9454E2 |
| C-01 Official Collection | 0x6FD053BfF10512d743Fa36C859e49351a4920df6 |
| KIWAMI Genesis | 0x701A038aF4Bd0fc9b69A829DdcB2f61185a49568 |
| IO: Imaginary Ones | 0x716F29B8972D551294d9E02B3eb0fC1107FbF4aA |
| My Curio Cards | 0x73DA73EF3a6982109c4d5BDb0dB9dd3E3783f313 |
| Psychedelics Anonymous Genesis | 0x75E95ba5997Eb235F40eCF8347cDb11F18ff640B |
| mfers | 0x79FCDEF22feeD20eDDacbB2587640e45491b757f |
| Adam Bomb Squad | 0x7AB2352b1D2e185560494D5e577F9D3c238b78C5 |
| Meebits | 0x7Bd29408f11D2bFC23c34f18275bBf23bB716Bc7 |
| Murakami.Flowers Official | 0x7D8820FA92EB1584636f4F5b8515B5476B75171a |
| JUNGLE FREAKS BY TROSLEY | 0x7E6Bc952d4b4bD814853301bEe48E99891424de0 |
| CyberKongz VX | 0x7EA3Cca10668B8346aeC0bf1844A49e995527c8B |
| FULL SEND METACARD NFT | 0x7eCb204feD7e386386CAb46a1fcB823ec5067aD5 |
| Wolf Game | 0x7F36182DeE28c45dE6072a34D29855BaE76DBe2f |
| Chimpers | 0x80336Ad7A747236ef41F47ed2C7641828a480BAA |
| Neo Tokyo Identities | 0x86357A19E5537A8Fba9A004E555713BC943a66C0 |
| RTFKT - MNLTH | 0x86825dFCa7A6224cfBd2DA48e85DF2fc3Aa7C4B1 |
| Cool Pets NFT | 0x86C10D10ECa1Fca9DAF87a279ABCcabe0063F247 |
| CyberBrokers | 0x892848074ddeA461A15f337250Da3ce55580CA85 |
| Lazy Lions | 0x8943C7bAC1914C9A7ABa750Bf2B6B09Fd21037E0 |
| Doodles | 0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e |
| MekaVerse | 0x9A534628B4062E123cE7Ee2222ec20B86e16Ca8F |
| ZombieClub Token | 0x9c80777CAe192E5031c38A0d951C55730eCC3f5e |
| Galaxy-Eggs | 0xA08126f5E1ED91A635987071E6FF5EB2aEb67C48 |
| Worldwide Webb Land | 0xA1D4657e0E6507D5a94d06DA93E94dC7C8c44b51 |
| VeeFriends | 0xa3AEe8BcE55BEeA1951EF834b99f3Ac60d1ABeeB |
| Coolman's Universe | 0xa5C0Bd78D1667c13BFB403E2a3336871396713c5 |
| Akutars | 0xaaD35C2DadbE77f97301617D82e661776c891Fa9 |
| MutantCats | 0xaAdBA140Ae5e4c8a9eF0Cc86EA3124b446e3E46A |
| Damien Hirst - The Currency | 0xaaDc2D4261199ce24A4B0a57370c4FCf43BB60aa |
| Vox Collectibles | 0xad9Fd7cB4fC7A0fBCE08d64068f60CbDE22Ed34C |
| Lives of Asuna | 0xAf615B61448691fC3E4c61AE4F015d6e77b6CCa8 |
| 3Landers | 0xb4d06d46A8285F4EC79Fd294F78a881799d8cEd9 |
| Boss Beauties | 0xB5C747561a185A146f83cFff25BdfD2455b31fF4 |
| Bored Ape Kennel Club | 0xba30E5F9Bb24caa003E9f2f0497Ad287FDF95623 |
| Bored Ape Yacht Club | 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D |
| goblintown.wtf | 0xbCe3781ae7Ca1a5e050Bd9C4c77369867eBc307e |
| Pudgy Penguins | 0xBd3531dA5CF5857e7CfAA92426877b022e612cf8 |
| NFT Worlds | 0xBD4455dA5929D5639EE098ABFaa3241e9ae111Af |
| CryptoSkulls | 0xc1Caf0C19A8AC28c41Fe59bA6c754e4b9bd54dE9 |
| Hashmasks | 0xC2C747E0F7004F9E8817Db2ca4997657a7746928 |
| Official Wrapped MoonCats (Acclimated) | 0xc3f733ca98E0daD0386979Eb96fb1722A1A05E69 |
| CryptoBatz by Ozzy Osbourne | 0xc8adFb4D437357D0A656D4e62fd9a6D22e401aa0 |
| Creature World NFT | 0xc92cedDfb8dd984A89fb494c376f9A48b999aAFc |
| tubby cats by tubby collective | 0xCa7cA7BcC765F77339bE2d648BA53ce9c8a262bD |
| FLUF World | 0xCcc441ac31f02cD96C153DB6fd5Fe0a2F4e6A68d |
| dotdotdots | 0xcE25E60A89F200B1fA40f6c313047FFe386992c3 |
| Karafuru | 0xd2F668a8461D6761115dAF8Aeb3cDf5F40C532C6 |
| Zipcy's SuperNormal | 0xd532b88607B1877Fe20c181CBa2550E3BbD6B31C |
| Lil' Heroes by Edgar Plans | 0xD78b76Fcc33cd416dA9d3D42f72649a23D7AC647 |
| PREMINT Collector Pass - OFFICIAL | 0xe0176bA60efddb29Cac5b15338C9962dAee9de0c |
| World of Women | 0xe785E82358879F061BC3dcAC6f0444462D4b5330 |
| Azuki | 0xED5AF388653567Af2F388E6224dC7C4b3241C544 |
| Rumble Kong League | 0xEf0182dc0574cd5874494a120750FD222FdB909a |
| The Doge Pound | 0xF4ee95274741437636e748DdAc70818B4ED7d043 |
| Project NANOPASS | 0xf54cC94f1F2f5De012B6Aa51F1E7eBdc43Ef5afC |
| Capsule House | 0xfcB1315C4273954F74Cb16D5b663DBF479EEC62e |
| Creepz Genesis | 0xfE8C6d19365453D26af321D0e8c910428c23873F |
| Loot (for Adventurers) | 0xFF9C1b15B16263C61d017ee9F65C50e4AE0113D7 |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://banksea-finance.gitbook.io/banksea-oracle-api/oracle/ethereum-oracle.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.