API Documentation

// Fetch VYO price in your wallet app
const res = await fetch('https://coinslist.vyochain.com/api/v1/prices?symbols=VYO');
const { prices } = await res.json();
console.log(prices.VYO.price); // 5.01

// Show token logo
<img src="https://coinslist.vyochain.com/api/v1/logo/native" alt="VYO" />

Parameters

{
  "tokens": [
    {
      "address": "native",
      "chain": 7771777,
      "symbol": "VYO",
      "name": "VALYGO",
      "decimals": 18,
      "isNative": true,
      "logo": "https://coinslist.vyochain.com/logos/native.png",
      "price": {
        "value": 5.01,
        "source": "manual",
        "currency": "USD",
        "change24h": 0
      },
      "supply": {
        "total": "100000000",
        "circulating": "94000000",
        "burned": "6000000"
      },
      "market": {
        "marketCap": 470940000,
        "volume24h": 0,
        "holders": 9560,
        "transfers": 974347
      },
      "metadata": {
        "description": "Native gas token...",
        "website": "https://valygo.com",
        "twitter": "https://x.com/valygochain",
        "telegram": "https://t.me/valygochain",
        "tags": ["Native", "Gas", "Governance"]
      },
      "status": {
        "verified": true,
        "claimed": true,
        "featured": true,
        "listedAt": "2025-11-01T00:00:00Z",
        "lastScanned": "2026-05-21T12:55:05Z"
      }
    }
  ],
  "count": 4,
  "chain": "all",
  "timestamp": "2026-05-21T13:00:00Z"
}

Parameters

{
  "prices": {
    "VYO": {
      "address": "native",
      "chain": 7771777,
      "decimals": 18,
      "price": 5.01,
      "source": "manual",
      "change24h": 0,
      "marketCap": 470940000,
      "volume24h": 0,
      "logo": "/logos/native.png"
    },
    "PGD": {
      "address": "0xA3908b0DcC520dc2af29265E60662e7c7c0dDd12",
      "chain": 7771777,
      "decimals": 18,
      "price": null,
      "source": "none",
      "change24h": 0,
      "marketCap": 0,
      "volume24h": 0,
      "logo": null
    }
  },
  "count": 2,
  "timestamp": "2026-05-21T13:00:00Z"
}

Parameters

HTTP/1.1 302 Found
Location: https://coinslist.vyochain.com/logos/native.png

// If no logo uploaded:
{
  "error": "No logo uploaded",
  "symbol": "PGD",
  "fallback": "PG"
}

// Fetch all token prices
async function getVYOPrices() {
  const res = await fetch('https://coinslist.vyochain.com/api/v1/prices');
  const { prices } = await res.json();
  return prices;
}

// Get specific token
async function getToken(address) {
  const res = await fetch(`https://coinslist.vyochain.com/api/v1/tokens?address=${address}`);
  const { token } = await res.json();
  return token;
}

// Display logo (React)
function TokenIcon({ address }) {
  return <img src={`https://coinslist.vyochain.com/api/v1/logo/${address}`} width={32} height={32} />;
}

import requests

# Get all prices
prices = requests.get('https://coinslist.vyochain.com/api/v1/prices').json()['prices']
vyo_price = prices['VYO']['price']
print(f"VYO: {vyo_price}")

# Get single token
token = requests.get('https://coinslist.vyochain.com/api/v1/tokens', params={'address': 'native'}).json()['token']
print(f"{'{token["symbol"]}'}: {'{token["supply"]["circulating"]}'} circulating")

# All tokens
curl -s https://coinslist.vyochain.com/api/v1/tokens | jq .

# Just prices
curl -s "https://coinslist.vyochain.com/api/v1/prices?symbols=VYO,PGD" | jq .

# Logo redirect
curl -sI https://coinslist.vyochain.com/api/v1/logo/native

func fetchVYOPrice() async throws -> Double? {
    let url = URL(string: "https://coinslist.vyochain.com/api/v1/prices?symbols=VYO")!
    let (data, _) = try await URLSession.shared.data(from: url)
    let json = try JSONSerialization.jsonObject(with: data) as? [String: Any]
    let prices = json?["prices"] as? [String: Any]
    let vyo = prices?["VYO"] as? [String: Any]
    return vyo?["price"] as? Double
}

All endpoints are rate limited to 60 requests per minute per IP address.

Responses include cache headers. The /api/v1/prices endpoint caches for 30 seconds, /api/v1/tokens for 60 seconds, and /api/v1/logo for 1 hour. Use the cache — polling more frequently than the cache window gives you the same data.

For real-time price feeds (sub-second updates), read VYOSwap pair contracts directly via RPC instead of polling this API.