Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.neyrs.cloud/llms.txt

Use this file to discover all available pages before exploring further.

All API requests require authentication via Bearer token in the Authorization header.

​
API Keys

Generate API keys from the Developer Dashboard at docs.neyrs.cloud/dashboard

​
Key Format

neyrs_live_abc123def456
neyrs_test_xyz789ghi012
  • live_ prefix for production keys
  • test_ prefix for development keys

​
Using API Keys

Include the API key in the Authorization header: 
curl --request GET \
  --url https://api.neyrs.cloud/v1/analytics/metrics \
  --header 'Authorization: Bearer neyrs_live_abc123def456'

​
Key Management

​
Creating Keys

POST /v1/keys

{
  "name": "Production API Key",
  "scopes": ["read:portfolio", "write:messages"],
  "expiresAt": "2025-03-08T00:00:00Z"
}

​
Revoking Keys

DELETE /v1/keys/{keyId}

​
Rotating Keys

POST /v1/keys/{keyId}/rotate
Returns a new key while keeping the old key active for 24 hours.

​
Scopes

Control API access with granular scopes:
ScopeDescription
read:portfolioView wallet balances and holdings
read:messagesView message history
write:messagesSend messages to agent
write:sessionsCreate and manage sessions
read:pricesAccess token price data
adminFull account access

​
Security Best Practices

​
Environment Variables

const neyrs = new NeyrsSDK({
  apiKey: process.env.NEYRS_API_KEY
});

​
Key Rotation

Rotate keys every 90 days for security.

​
Least Privilege

Grant only required scopes to each key.

​
Monitoring

Monitor key usage in the dashboard for suspicious activity.
Never expose API keys in client-side code, public repositories, or logs. If a key is compromised, revoke it immediately.
Test keys are limited to 100 requests per day and can only interact with Solana devnet.