curl --request POST \
--url https://api.neyrs.cloud/v1/messages \
--header 'Authorization: Bearer neyrs_live_abc123def456' \
--header 'Content-Type: application/json' \
--data '{
"sessionId": "session_abc123def456",
"message": "Swap 5 SOL for USDC",
"slippage": 50
}'
const response = await fetch('https://api.neyrs.cloud/v1/messages', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.NEYRS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
sessionId: 'session_abc123def456',
message: 'Swap 5 SOL for USDC',
slippage: 50
})
});
import requests
response = requests.post(
'https://api.neyrs.cloud/v1/messages',
headers={
'Authorization': f'Bearer {api_key}',
'Content-Type': 'application/json'
},
json={
'sessionId': 'session_abc123def456',
'message': 'Swap 5 SOL for USDC',
'slippage': 50
}
)
{
"messageId": "msg_abc123def456",
"sessionId": "session_abc123def456",
"intent": {
"action": "swap",
"confidence": 0.98
},
"response": "I'll swap 5 SOL for USDC. Expected output: ~736.25 USDC with 0.12% price impact via Orca Whirlpool.",
"transaction": {
"type": "swap",
"parameters": {
"inputToken": "So11111111111111111111111111111111111111112",
"outputToken": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": 5000000000
},
"route": {
"inAmount": "5000000000",
"outAmount": "736250000",
"priceImpact": 0.12
}
},
"timestamp": "2024-03-08T14:30:00Z"
}
{
"error": {
"code": "parsing_error",
"message": "Could not extract transaction parameters",
"details": {
"reason": "Ambiguous intent - please specify tokens and amounts"
}
}
}
Messages
Send Message
Send a message to Neyrs agent
POST
/
v1
/
messages
curl --request POST \
--url https://api.neyrs.cloud/v1/messages \
--header 'Authorization: Bearer neyrs_live_abc123def456' \
--header 'Content-Type: application/json' \
--data '{
"sessionId": "session_abc123def456",
"message": "Swap 5 SOL for USDC",
"slippage": 50
}'
const response = await fetch('https://api.neyrs.cloud/v1/messages', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.NEYRS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
sessionId: 'session_abc123def456',
message: 'Swap 5 SOL for USDC',
slippage: 50
})
});
import requests
response = requests.post(
'https://api.neyrs.cloud/v1/messages',
headers={
'Authorization': f'Bearer {api_key}',
'Content-Type': 'application/json'
},
json={
'sessionId': 'session_abc123def456',
'message': 'Swap 5 SOL for USDC',
'slippage': 50
}
)
{
"messageId": "msg_abc123def456",
"sessionId": "session_abc123def456",
"intent": {
"action": "swap",
"confidence": 0.98
},
"response": "I'll swap 5 SOL for USDC. Expected output: ~736.25 USDC with 0.12% price impact via Orca Whirlpool.",
"transaction": {
"type": "swap",
"parameters": {
"inputToken": "So11111111111111111111111111111111111111112",
"outputToken": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": 5000000000
},
"route": {
"inAmount": "5000000000",
"outAmount": "736250000",
"priceImpact": 0.12
}
},
"timestamp": "2024-03-08T14:30:00Z"
}
{
"error": {
"code": "parsing_error",
"message": "Could not extract transaction parameters",
"details": {
"reason": "Ambiguous intent - please specify tokens and amounts"
}
}
}
Authorization
string
required
Bearer token. Format:
Bearer neyrs_live_abc123def456Body Parameters
string
required
Session ID. Format:
session_<16 chars>string
required
Natural language command. Max 500 characters.Examples: “Swap 5 SOL for USDC”, “Show my balance”
number
Slippage tolerance in basis points. Default: 50 (0.5%)
Response
string
Unique message identifier
string
Session identifier
object
Parsed intent from messageProperties:
action(string): Action type (swap, transfer, query)confidence(number): Parsing confidence (0-1)
string
Agent response text
object
Transaction details (if applicable)Properties:
type(string): Transaction typeparameters(object): Transaction parametersroute(object): Routing information
string
ISO 8601 timestamp
curl --request POST \
--url https://api.neyrs.cloud/v1/messages \
--header 'Authorization: Bearer neyrs_live_abc123def456' \
--header 'Content-Type: application/json' \
--data '{
"sessionId": "session_abc123def456",
"message": "Swap 5 SOL for USDC",
"slippage": 50
}'
const response = await fetch('https://api.neyrs.cloud/v1/messages', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.NEYRS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
sessionId: 'session_abc123def456',
message: 'Swap 5 SOL for USDC',
slippage: 50
})
});
import requests
response = requests.post(
'https://api.neyrs.cloud/v1/messages',
headers={
'Authorization': f'Bearer {api_key}',
'Content-Type': 'application/json'
},
json={
'sessionId': 'session_abc123def456',
'message': 'Swap 5 SOL for USDC',
'slippage': 50
}
)
{
"messageId": "msg_abc123def456",
"sessionId": "session_abc123def456",
"intent": {
"action": "swap",
"confidence": 0.98
},
"response": "I'll swap 5 SOL for USDC. Expected output: ~736.25 USDC with 0.12% price impact via Orca Whirlpool.",
"transaction": {
"type": "swap",
"parameters": {
"inputToken": "So11111111111111111111111111111111111111112",
"outputToken": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": 5000000000
},
"route": {
"inAmount": "5000000000",
"outAmount": "736250000",
"priceImpact": 0.12
}
},
"timestamp": "2024-03-08T14:30:00Z"
}
{
"error": {
"code": "parsing_error",
"message": "Could not extract transaction parameters",
"details": {
"reason": "Ambiguous intent - please specify tokens and amounts"
}
}
}