Path Parameters

key

string

REQUIRED

The unique key associated with the list

item

string

REQUIRED

The item to check for in the list

Returns

data

object

The data object which contains the following fields:

exists

boolean

Indicates whether the specified item is present in the Key-Value Store list

Request

1
curl -X GET \
2
    "https://api.quicknode.com/kv/rest/v1/lists/{key}/contains/{item}" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY"    

1
curl -X GET \
2
    "https://api.quicknode.com/kv/rest/v1/lists/{key}/contains/{item}" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY"    

1
var myHeaders = new Headers();
2
myHeaders.append('accept', 'application/json');
3
myHeaders.append('Content-Type', 'application/json');
4
myHeaders.append('x-api-key', 'YOUR_API_KEY'); // Replace with your actual API key
5

6
var requestOptions = {
7
  method: 'GET',
8
  headers: myHeaders,
9
  redirect: 'follow'
10
};
11

12
fetch('https://api.quicknode.com/kv/rest/v1/lists/{key}/contains/{item}', requestOptions)
13
  .then(response => response.text())
14
  .then(result => console.log(result))
15
  .catch(error => console.log('error', error));
16

1
var myHeaders = new Headers();
2
myHeaders.append('accept', 'application/json');
3
myHeaders.append('Content-Type', 'application/json');
4
myHeaders.append('x-api-key', 'YOUR_API_KEY'); // Replace with your actual API key
5

6
var requestOptions = {
7
  method: 'GET',
8
  headers: myHeaders,
9
  redirect: 'follow'
10
};
11

12
fetch('https://api.quicknode.com/kv/rest/v1/lists/{key}/contains/{item}', requestOptions)
13
  .then(response => response.text())
14
  .then(result => console.log(result))
15
  .catch(error => console.log('error', error));
16

1
import requests
2

3
url = "https://api.quicknode.com/kv/rest/v1/lists/{key}/contains/{item}"
4

5
headers = {
6
    "accept": "application/json",
7
    "Content-Type": "application/json",
8
    "x-api-key": "YOUR_API_KEY"  # Replace with your actual API key
9
}
10

11
response = requests.get(url, headers=headers)
12

13
print(response.text)
14

1
import requests
2

3
url = "https://api.quicknode.com/kv/rest/v1/lists/{key}/contains/{item}"
4

5
headers = {
6
    "accept": "application/json",
7
    "Content-Type": "application/json",
8
    "x-api-key": "YOUR_API_KEY"  # Replace with your actual API key
9
}
10

11
response = requests.get(url, headers=headers)
12

13
print(response.text)
14

1
require "uri"
2
require "net/http"
3
require "json"
4

5
# Set up the URL for the request
6
url = URI("https://api.quicknode.com/kv/rest/v1/lists/{key}")
7

8
https = Net::HTTP.new(url.host, url.port)
9
https.use_ssl = true
10

11
request = Net::HTTP::Get.new(url)
12
request["accept"] = "application/json"
13
request["Content-Type"] = "application/json"
14
request["x-api-key"] = "YOUR_API_KEY"  # Replace with your actual API key
15

16
response = https.request(request)
17
puts response.body
18

1
require "uri"
2
require "net/http"
3
require "json"
4

5
# Set up the URL for the request
6
url = URI("https://api.quicknode.com/kv/rest/v1/lists/{key}")
7

8
https = Net::HTTP.new(url.host, url.port)
9
https.use_ssl = true
10

11
request = Net::HTTP::Get.new(url)
12
request["accept"] = "application/json"
13
request["Content-Type"] = "application/json"
14
request["x-api-key"] = "YOUR_API_KEY"  # Replace with your actual API key
15

16
response = https.request(request)
17
puts response.body
18

1
qn kv list contains {list_key} {item} -o json

1
qn kv list contains {list_key} {item} -o json

1
import { QuicknodeSdk } from "@quicknode/sdk"
2

3
const qn = new QuicknodeSdk({ apiKey: "YOUR_API_KEY" })
4

5
const response = await qn.kvstore.listContainsItem("watchlist", "0x0000000000000000000000000000000000000000")
6
console.log(response)
7

1
import { QuicknodeSdk } from "@quicknode/sdk"
2

3
const qn = new QuicknodeSdk({ apiKey: "YOUR_API_KEY" })
4

5
const response = await qn.kvstore.listContainsItem("watchlist", "0x0000000000000000000000000000000000000000")
6
console.log(response)
7

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4

5
async def main():
6
    qn = QuicknodeSdk(SdkFullConfig(api_key="YOUR_API_KEY"))
7
    response = await qn.kvstore.list_contains_item("watchlist", "0x0000000000000000000000000000000000000000")
8
    print(response)
9

10

11
asyncio.run(main())
12

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4

5
async def main():
6
    qn = QuicknodeSdk(SdkFullConfig(api_key="YOUR_API_KEY"))
7
    response = await qn.kvstore.list_contains_item("watchlist", "0x0000000000000000000000000000000000000000")
8
    print(response)
9

10

11
asyncio.run(main())
12

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: "YOUR_API_KEY")
4

5
response = qn.kvstore.list_contains_item(key: "watchlist", item: "0x0000000000000000000000000000000000000000")
6
puts response
7

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: "YOUR_API_KEY")
4

5
response = qn.kvstore.list_contains_item(key: "watchlist", item: "0x0000000000000000000000000000000000000000")
6
puts response
7

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::builder().api_key("YOUR_API_KEY").build())?;
6
    let response = qn.kvstore.list_contains_item("watchlist", "0x0000000000000000000000000000000000000000").await?;
7

8
    println!("{:?}", response);
9
    Ok(())
10
}
11

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::builder().api_key("YOUR_API_KEY").build())?;
6
    let response = qn.kvstore.list_contains_item("watchlist", "0x0000000000000000000000000000000000000000").await?;
7

8
    println!("{:?}", response);
9
    Ok(())
10
}
11

Try in Swagger

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free