THIS WEEK'S SUNSETS

Koh Samui sunrise & sunset times — click any time to add it directly to Google Calendar.

Loading sunrise & sunset times…

Get Your Sunset Calendar

Enter your travel dates below. You'll get an .ics calendar file with exact sunrise and sunset times for each day of your Koh Samui stay. Import it into Google Calendar and set notifications — only for the days you're on the island.

How to add to Google Calendar after download:

Open Google Calendar
Click the gear icon → Settings
Click Import & Export → Import
Select the downloaded .ics file
Set notifications on the imported calendar: 30 min before

Payment uses the x402 protocol — 0.01 USDC on Base. You need an x402-compatible wallet or client. Try AgentCash for easy x402 payments.

Generate Your Calendar

Clicking the button opens functions-falling-night-3857.fly.dev/api/sunset with your dates. Your x402 client handles the 0.01 USDC payment and downloads the .ics file.

FOR AI AGENTS

Any x402-compatible agent can autonomously pay 0.01 USDC and receive a .ics calendar — no human in the loop.

Autonomous

Agent calls the endpoint → receives HTTP 402 with payment requirements → pays 0.01 USDC via facilitator → retries with X-Payment header → receives .ics file. No human interaction needed.

Cheap

0.01 USDC per request. On-chain micropayment on Base. No API key, no subscription, no account. Pay only for what you use, per call.

Standard

Built on the open x402 protocol. USDC on Base. Works with any x402-compatible SDK in JavaScript, Python, Go, or any language.

Code Examples

# Install: no dependencies needed
# Step 1 — call endpoint, receive HTTP 402
curl -si "https://functions-falling-night-3857.fly.dev/api/sunset?start=2025-01-10&end=2025-01-12"

# Step 2 — the 402 response body contains payment requirements JSON:
# { "accepts": [{ "scheme": "exact", "network": "base-sepolia",
#   "maxAmountRequired": "10000", "asset": "0x036C...", "payTo": "0xE812..." }] }

# Step 3 — pay via x402 facilitator, get proof, retry with header
curl -H "X-Payment: <proof>" \
  "https://functions-falling-night-3857.fly.dev/api/sunset?start=2025-01-10&end=2025-01-12" \
  -o sunset-koh-samui.ics

// npm install x402-fetch viem
import { wrapFetchWithPayment } from 'x402-fetch';
import { createWalletClient, http } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { baseSepolia } from 'viem/chains';

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const client = createWalletClient({ account, chain: baseSepolia, transport: http() });
const fetchWithPayment = wrapFetchWithPayment(fetch, client);

const res = await fetchWithPayment(
  'https://functions-falling-night-3857.fly.dev/api/sunset?start=2025-01-10&end=2025-01-12'
);
const ics = await res.text(); // BEGIN:VCALENDAR ...

# pip install "x402[requests]" "x402[evm]" eth-account
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

client = x402ClientSync()
account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
register_exact_evm_client(client, EthAccountSigner(account))

with x402_requests(client) as session:
    r = session.get("https://functions-falling-night-3857.fly.dev/api/sunset?start=2025-01-10&end=2025-01-12")
    with open("sunset.ics", "w") as f:
        f.write(r.text)  # BEGIN:VCALENDAR ...

Health check (free): https://functions-falling-night-3857.fly.dev/api/health · Protocol: x402.org · Network: Base / Base Sepolia

READY FOR YOUR SUNSET CALENDAR?