Path Parameters

key

string

REQUIRED

The unique key associated with the list

Body Parameters

item

string

REQUIRED

The item to add 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/{key}/items" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY" \
6
    -d $'{
7
  "item": "new-item"
8
}'
9

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

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
    item: 'new-item'
12
  })
13
};
14

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

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
    item: 'new-item'
12
  })
13
};
14

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

1
import requests
2

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

5
payload = {
6
    "item": "new-item"
7
}
8

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

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

17
print(response.text)
18

1
import requests
2

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

5
payload = {
6
    "item": "new-item"
7
}
8

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

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

17
print(response.text)
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}/items")
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
request.body = {
16
  "item": "new-item"
17
}.to_json
18

19
response = https.request(request)
20
puts response.body
21

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}/items")
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
request.body = {
16
  "item": "new-item"
17
}.to_json
18

19
response = https.request(request)
20
puts response.body
21

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

1
qn kv list append {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.addListItem("watchlist", { item: "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.addListItem("watchlist", { item: "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.add_list_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.add_list_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.add_list_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.add_list_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.add_list_item("watchlist", &quicknode_sdk::kvstore::AddListItemParams { item: "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.add_list_item("watchlist", &quicknode_sdk::kvstore::AddListItemParams { item: "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