Body Parameters

key

string

REQUIRED

The unique identifier for the list

items

array

REQUIRED

An array of items to be added to the list

Returns

code

number

Response status code

msg

string

Response message

data

null

No additional data

Request

1
curl -X POST \
2
    "https://api.quicknode.com/kv/rest/v1/lists" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY" \
6
    -d $'{
7
  "key": "my-list",
8
  "items": ["item1"]
9
}'
10
    

1
curl -X POST \
2
    "https://api.quicknode.com/kv/rest/v1/lists" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY" \
6
    -d $'{
7
  "key": "my-list",
8
  "items": ["item1"]
9
}'
10
    

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: 'POST',
8
  headers: myHeaders,
9
  redirect: 'follow',
10
  body: JSON.stringify({
11
    key: 'my-key',
12
    items: ['item1']
13
  })
14
};
15

16
fetch('https://api.quicknode.com/kv/rest/v1/lists', requestOptions)
17
  .then(response => response.text())
18
  .then(result => console.log(result))
19
  .catch(error => console.log('error', error));
20

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: 'POST',
8
  headers: myHeaders,
9
  redirect: 'follow',
10
  body: JSON.stringify({
11
    key: 'my-key',
12
    items: ['item1']
13
  })
14
};
15

16
fetch('https://api.quicknode.com/kv/rest/v1/lists', requestOptions)
17
  .then(response => response.text())
18
  .then(result => console.log(result))
19
  .catch(error => console.log('error', error));
20

1
import requests
2

3
url = "https://api.quicknode.com/kv/rest/v1/lists"
4

5
payload = {
6
    "key": "my-list",
7
    "items": ["item1"]
8
}
9

10
headers = {
11
    "accept": "application/json",
12
    "Content-Type": "application/json",
13
    "x-api-key": "YOUR_API_KEY"  # Replace with your actual API key
14
}
15

16
response = requests.post(url, headers=headers, json=payload)
17

18
print(response.text)
19

1
import requests
2

3
url = "https://api.quicknode.com/kv/rest/v1/lists"
4

5
payload = {
6
    "key": "my-list",
7
    "items": ["item1"]
8
}
9

10
headers = {
11
    "accept": "application/json",
12
    "Content-Type": "application/json",
13
    "x-api-key": "YOUR_API_KEY"  # Replace with your actual API key
14
}
15

16
response = requests.post(url, headers=headers, json=payload)
17

18
print(response.text)
19

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")
7

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

11
request = Net::HTTP::Post.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
request.body = {
17
  "key" => "my-list",
18
  "items" => ["item1"]
19
}.to_json
20

21
response = https.request(request)
22
puts response.body
23

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")
7

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

11
request = Net::HTTP::Post.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
request.body = {
17
  "key" => "my-list",
18
  "items" => ["item1"]
19
}.to_json
20

21
response = https.request(request)
22
puts response.body
23

1
qn kv list create {list_key} {item_1} {item_2} -o json

1
qn kv list create {list_key} {item_1} {item_2} -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.createList({ key: "watchlist", items: ["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.createList({ key: "watchlist", items: ["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.create_list("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.create_list("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.create_list(key: "watchlist", items: ["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.create_list(key: "watchlist", items: ["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.create_list(&quicknode_sdk::kvstore::CreateListParams { key: "watchlist".to_string(), items: vec!["0x0000000000000000000000000000000000000000".to_string()] }).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.create_list(&quicknode_sdk::kvstore::CreateListParams { key: "watchlist".to_string(), items: vec!["0x0000000000000000000000000000000000000000".to_string()] }).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