curl --request POST \
--url https://api.neyrs.cloud/v1/sessions \
--header 'Authorization: Bearer neyrs_live_abc123def456' \
--header 'Content-Type: application/json' \
--data '{
"walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
}'
const response = await fetch('https://api.neyrs.cloud/v1/sessions', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.NEYRS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
walletAddress: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU'
})
});
import requests
response = requests.post(
'https://api.neyrs.cloud/v1/sessions',
headers={
'Authorization': f'Bearer {api_key}',
'Content-Type': 'application/json'
},
json={
'walletAddress': '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU'
}
)
{
"sessionId": "session_abc123def456",
"walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"createdAt": "2024-03-08T14:30:00Z",
"expiresAt": "2024-03-09T14:30:00Z"
}
{
"error": {
"code": "validation_error",
"message": "Invalid wallet address format",
"field": "walletAddress"
}
}
Chat Operations
Create Session
Initialize a new chat session with Neyrs agent
POST
/
v1
/
sessions
curl --request POST \
--url https://api.neyrs.cloud/v1/sessions \
--header 'Authorization: Bearer neyrs_live_abc123def456' \
--header 'Content-Type: application/json' \
--data '{
"walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
}'
const response = await fetch('https://api.neyrs.cloud/v1/sessions', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.NEYRS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
walletAddress: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU'
})
});
import requests
response = requests.post(
'https://api.neyrs.cloud/v1/sessions',
headers={
'Authorization': f'Bearer {api_key}',
'Content-Type': 'application/json'
},
json={
'walletAddress': '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU'
}
)
{
"sessionId": "session_abc123def456",
"walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"createdAt": "2024-03-08T14:30:00Z",
"expiresAt": "2024-03-09T14:30:00Z"
}
{
"error": {
"code": "validation_error",
"message": "Invalid wallet address format",
"field": "walletAddress"
}
}
Authorization
string
required
Bearer token. Format:
Bearer neyrs_live_abc123def456Body Parameters
string
required
Solana wallet address. Format: Base58 encoded public key
object
Optional session metadataProperties:
userAgent(string): Client user agentipAddress(string): Client IP addressreferrer(string): Referrer URL
Response
string
Unique session identifier. Format:
session_<16 chars>string
Connected wallet address
string
ISO 8601 timestamp of session creation
string
ISO 8601 timestamp of session expiration (24 hours)
curl --request POST \
--url https://api.neyrs.cloud/v1/sessions \
--header 'Authorization: Bearer neyrs_live_abc123def456' \
--header 'Content-Type: application/json' \
--data '{
"walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
}'
const response = await fetch('https://api.neyrs.cloud/v1/sessions', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.NEYRS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
walletAddress: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU'
})
});
import requests
response = requests.post(
'https://api.neyrs.cloud/v1/sessions',
headers={
'Authorization': f'Bearer {api_key}',
'Content-Type': 'application/json'
},
json={
'walletAddress': '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU'
}
)
{
"sessionId": "session_abc123def456",
"walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"createdAt": "2024-03-08T14:30:00Z",
"expiresAt": "2024-03-09T14:30:00Z"
}
{
"error": {
"code": "validation_error",
"message": "Invalid wallet address format",
"field": "walletAddress"
}
}