Go

Go SDK

A community-maintained Go client for GEX Engine. Provides idiomatic Go interfaces with context support, structured error types, and WebSocket streaming via goroutines.

Installation

go get github.com/gexengine/gex-go

Client Setup

package main

import (
    "context"
    "fmt"
    "log"
    "os"

    gex "github.com/gexengine/gex-go"
)

func main() {
    client := gex.NewClient(gex.WithAPIKey(os.Getenv("GEX_API_KEY")))

    ctx := context.Background()

    // Fetch gamma exposure
    result, err := client.GEX(ctx, "SPX")
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("Total GEX: %d\n", result.Data.TotalGEX)
    fmt.Printf("Regime:    %s\n", result.Data.Regime)
    fmt.Printf("Spot:      %.2f\n", result.Meta.Spot)
}

Fetching Data

Gamma Exposure

result, err := client.GEX(ctx, "SPX")
if err != nil {
    log.Fatal(err)
}

fmt.Printf("Total GEX:  %d\n", result.Data.TotalGEX)
fmt.Printf("Net GEX:    %d\n", result.Data.NetGEX)
fmt.Printf("Call GEX:   %d\n", result.Data.CallGEX)
fmt.Printf("Put GEX:    %d\n", result.Data.PutGEX)

Key Levels

levels, err := client.Levels(ctx, "SPX")
if err != nil {
    log.Fatal(err)
}

fmt.Printf("Gamma Flip: %.2f\n", levels.Data.GammaFlip)
fmt.Printf("Put Wall:   %.0f\n", levels.Data.PutWall)
fmt.Printf("Call Wall:  %.0f\n", levels.Data.CallWall)

Streaming

ch, err := client.Stream(ctx, "SPX", gex.Channels("gex", "regime"))
if err != nil {
    log.Fatal(err)
}

for update := range ch {
    switch update.Channel {
    case "gex":
        fmt.Printf("GEX update: %d\n", update.Data["total_gex"])
    case "regime":
        fmt.Printf("Regime: %s (strength: %.2f)\n",
            update.Data["regime"], update.Data["strength"])
    }
}

Error Handling

result, err := client.GEX(ctx, "SPX")
if err != nil {
    var apiErr *gex.APIError
    if errors.As(err, &apiErr) {
        fmt.Printf("API error %d: %s\n", apiErr.StatusCode, apiErr.Detail)
        if apiErr.StatusCode == 429 {
            fmt.Printf("Retry after %ds\n", apiErr.RetryAfter)
        }
    }
    return
}