Skip to main content

​
Endpoint

GET  /event
POST /event

​
Description

Returns upcoming and recent cryptocurrency events including conferences, product launches, network upgrades, and other significant calendar events.

​
Pricing

$0.01 USD per request (paid in USDC via x402)

​
Parameters

​
ticker
string
default:"general"
Cryptocurrency ticker symbol (e.g., BTC, ETH, SOL) or “general” for all events

​
Request Examples

​
GET Request

curl -X GET "https://api.syraa.fun/event?ticker=ETH"

​
POST Request

curl -X POST https://api.syraa.fun/event \
  -H "Content-Type: application/json" \
  -d '{"ticker": "BTC"}'

​
General Events

curl -X GET "https://api.syraa.fun/event"

​
Response

​
event
array
Array of event objects grouped by date

​
Success Response

{
  "event": [
    {
      "date": "2026-03-15",
      "ticker": {
        "events": [
          {
            "title": "Ethereum DevCon 2026",
            "description": "Annual Ethereum developer conference",
            "location": "Singapore",
            "type": "conference"
          }
        ]
      }
    },
    {
      "date": "2026-04-01",
      "general": {
        "events": [
          {
            "title": "Bitcoin Halving",
            "description": "Fourth Bitcoin block reward halving",
            "type": "network_upgrade"
          }
        ]
      }
    }
  ]
}

​
Error Responses

​
404 Not Found

{
  "error": "Event not found"
}

​
500 Internal Error

{
  "error": "Failed to fetch event"
}

​
Caching

Event data is cached for 90 seconds to improve performance and reduce costs.

​
Event Types

Events may include:
  • Conferences - Developer and community conferences
  • Network Upgrades - Hard forks, protocol updates
  • Product Launches - New product and feature releases
  • Token Events - Token unlocks, airdrops
  • Regulatory - Policy announcements, regulatory deadlines

​
Ticker Resolution

Tickers are resolved via CoinGecko: 
const ticker = await resolveTicker("ETH", true);
// Returns: "ETH" or "general" if not found

​
Code Example

// Get Ethereum events
const response = await fetch('https://api.syraa.fun/event?ticker=ETH');
const data = await response.json();

data.event.forEach(dateGroup => {
  console.log(`Events on ${dateGroup.date}:`);
  if (dateGroup.ticker?.events) {
    dateGroup.ticker.events.forEach(e => {
      console.log(`  - ${e.title}`);
    });
  }
});

​
Best Practices

  1. Filter by Ticker: Get events relevant to specific cryptocurrencies
  2. Check Dates: Events are organized chronologically
  3. Handle Both Types: Process both ticker-specific and general events
  4. Use Caching: Benefit from 90-second cache window

Build docs developers (and LLMs) love

Get started for freeTalk to us