Skip to main content
GET
/
v1
/
portfolio
curl --request GET \
  --url 'https://api.neyrs.cloud/v1/portfolio?walletAddress=7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU' \
  --header 'Authorization: Bearer neyrs_live_abc123def456'

const response = await fetch(
  'https://api.neyrs.cloud/v1/portfolio?walletAddress=7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
  {
    headers: {
      'Authorization': `Bearer ${process.env.NEYRS_API_KEY}`
    }
  }
);

import requests

response = requests.get(
    'https://api.neyrs.cloud/v1/portfolio',
    params={
        'walletAddress': '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU'
    },
    headers={
        'Authorization': f'Bearer {api_key}'
    }
)

{
  "walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "totalValue": 7389.81,
  "tokens": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "balance": 12.45,
      "decimals": 9,
      "usdValue": 1867.50,
      "price": 150.00
    },
    {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "symbol": "USDC",
      "balance": 5432.10,
      "decimals": 6,
      "usdValue": 5432.10,
      "price": 1.00
    }
  ],
  "lastUpdated": "2024-03-08T14:30:00Z"
}

{
  "error": {
    "code": "validation_error",
    "message": "Invalid wallet address format"
  }
}

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer neyrs_live_abc123def456

​
Query Parameters

​
walletAddress
string
required
Solana wallet address

​
Response

​
walletAddress
string
Wallet address
​
totalValue
number
Total portfolio value in USD
​
tokens
array
Array of token holdingsEach token contains:
  • mint (string): Token mint address
  • symbol (string): Token symbol
  • balance (number): Token balance
  • decimals (number): Token decimals
  • usdValue (number): USD value
  • price (number): Current price per token
​
lastUpdated
string
ISO 8601 timestamp of last update
curl --request GET \
  --url 'https://api.neyrs.cloud/v1/portfolio?walletAddress=7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU' \
  --header 'Authorization: Bearer neyrs_live_abc123def456'

const response = await fetch(
  'https://api.neyrs.cloud/v1/portfolio?walletAddress=7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
  {
    headers: {
      'Authorization': `Bearer ${process.env.NEYRS_API_KEY}`
    }
  }
);

import requests

response = requests.get(
    'https://api.neyrs.cloud/v1/portfolio',
    params={
        'walletAddress': '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU'
    },
    headers={
        'Authorization': f'Bearer {api_key}'
    }
)

{
  "walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "totalValue": 7389.81,
  "tokens": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "balance": 12.45,
      "decimals": 9,
      "usdValue": 1867.50,
      "price": 150.00
    },
    {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "symbol": "USDC",
      "balance": 5432.10,
      "decimals": 6,
      "usdValue": 5432.10,
      "price": 1.00
    }
  ],
  "lastUpdated": "2024-03-08T14:30:00Z"
}

{
  "error": {
    "code": "validation_error",
    "message": "Invalid wallet address format"
  }
}