feat: initial FRED API Proxy project

- Go web server using Gin framework
- Proxy FRED economic data API
- Support series, observations, search, releases endpoints
This commit is contained in:
2026-04-01 06:48:29 +00:00
commit 96711ffb35
10 changed files with 755 additions and 0 deletions

34
config/config.go Normal file
View File

@@ -0,0 +1,34 @@
package config
import (
"os"
)
type Config struct {
FREDAPIKey string
ServerPort string
FREDBaseURL string
}
func Load() *Config {
apiKey := os.Getenv("FRED_API_KEY")
if apiKey == "" {
apiKey = "987b9c3428a3d0fe90179e3e6298d05e"
}
port := os.Getenv("SERVER_PORT")
if port == "" {
port = "8080"
}
baseURL := os.Getenv("FRED_BASE_URL")
if baseURL == "" {
baseURL = "https://api.stlouisfed.org/fred"
}
return &Config{
FREDAPIKey: apiKey,
ServerPort: port,
FREDBaseURL: baseURL,
}
}

BIN
fred-api Executable file

Binary file not shown.

35
go.mod Normal file
View File

@@ -0,0 +1,35 @@
module fred-api
go 1.21
require (
github.com/gin-gonic/gin v1.9.1
github.com/joho/godotenv v1.5.1
)
require (
github.com/bytedance/sonic v1.9.1 // indirect
github.com/chenzhuoyu/base64x v0.0.0-20221115062448-fe3a3abad311 // indirect
github.com/gabriel-vasile/mimetype v1.4.2 // indirect
github.com/gin-contrib/sse v0.1.0 // indirect
github.com/go-playground/locales v0.14.1 // indirect
github.com/go-playground/universal-translator v0.18.1 // indirect
github.com/go-playground/validator/v10 v10.14.0 // indirect
github.com/goccy/go-json v0.10.2 // indirect
github.com/json-iterator/go v1.1.12 // indirect
github.com/klauspost/cpuid/v2 v2.2.4 // indirect
github.com/leodido/go-urn v1.2.4 // indirect
github.com/mattn/go-isatty v0.0.19 // indirect
github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
github.com/modern-go/reflect2 v1.0.2 // indirect
github.com/pelletier/go-toml/v2 v2.0.8 // indirect
github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
github.com/ugorji/go/codec v1.2.11 // indirect
golang.org/x/arch v0.3.0 // indirect
golang.org/x/crypto v0.9.0 // indirect
golang.org/x/net v0.10.0 // indirect
golang.org/x/sys v0.8.0 // indirect
golang.org/x/text v0.9.0 // indirect
google.golang.org/protobuf v1.30.0 // indirect
gopkg.in/yaml.v3 v3.0.1 // indirect
)

88
go.sum Normal file
View File

@@ -0,0 +1,88 @@
github.com/bytedance/sonic v1.5.0/go.mod h1:ED5hyg4y6t3/9Ku1R6dU/4KyJ48DZ4jPhfY1O2AihPM=
github.com/bytedance/sonic v1.9.1 h1:6iJ6NqdoxCDr6mbY8h18oSO+cShGSMRGCEo7F2h0x8s=
github.com/bytedance/sonic v1.9.1/go.mod h1:i736AoUSYt75HyZLoJW9ERYxcy6eaN6h4BZXU064P/U=
github.com/chenzhuoyu/base64x v0.0.0-20211019084208-fb5309c8db06/go.mod h1:DH46F32mSOjUmXrMHnKwZdA8wcEefY7UVqBKYGjpdQY=
github.com/chenzhuoyu/base64x v0.0.0-20221115062448-fe3a3abad311 h1:qSGYFH7+jGhDF8vLC+iwCD4WpbV1EBDSzWkJODFLams=
github.com/chenzhuoyu/base64x v0.0.0-20221115062448-fe3a3abad311/go.mod h1:b583jCggY9gE99b6G5LEC39OIiVsWj+R97kbl5odCEk=
github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/gabriel-vasile/mimetype v1.4.2 h1:w5qFW6JKBz9Y393Y4q372O9A7cUSequkh1Q7OhCmWKU=
github.com/gabriel-vasile/mimetype v1.4.2/go.mod h1:zApsH/mKG4w07erKIaJPFiX0Tsq9BFQgN3qGY5GnNgA=
github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE=
github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
github.com/gin-gonic/gin v1.9.1 h1:4idEAncQnU5cB7BeOkPtxjfCSye0AAm1R0RVIqJ+Jmg=
github.com/gin-gonic/gin v1.9.1/go.mod h1:hPrL7YrpYKXt5YId3A/Tnip5kqbEAP+KLuI3SUcPTeU=
github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA=
github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
github.com/go-playground/validator/v10 v10.14.0 h1:vgvQWe3XCz3gIeFDm/HnTIbj6UGmg/+t63MyGU2n5js=
github.com/go-playground/validator/v10 v10.14.0/go.mod h1:9iXMNT7sEkjXb0I+enO7QXmzG6QCsPWY4zveKFVRSyU=
github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU=
github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I=
github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk=
github.com/google/go-cmp v0.5.5 h1:Khx7svrCpmxxtHBq5j2mp/xVjsi8hQMfNLvJFAlrGgU=
github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
github.com/klauspost/cpuid/v2 v2.2.4 h1:acbojRNwl3o09bUq+yDCtZFc1aiwaAAxtcn8YkZXnvk=
github.com/klauspost/cpuid/v2 v2.2.4/go.mod h1:RVVoqg1df56z8g3pUjL/3lE5UfnlrJX8tyFgg4nqhuY=
github.com/leodido/go-urn v1.2.4 h1:XlAE/cm/ms7TE/VMVoduSpNBoyc2dOxHs5MZSwAN63Q=
github.com/leodido/go-urn v1.2.4/go.mod h1:7ZrI8mTSeBSHl/UaRyKQW1qZeMgak41ANeCNaVckg+4=
github.com/mattn/go-isatty v0.0.19 h1:JITubQf0MOLdlGRuRq+jtsDlekdYPia9ZFsB8h/APPA=
github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg=
github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
github.com/pelletier/go-toml/v2 v2.0.8 h1:0ctb6s9mE31h0/lhu+J6OPmVeDxJn+kYnJc2jZR9tGQ=
github.com/pelletier/go-toml/v2 v2.0.8/go.mod h1:vuYfssBdrU2XDZ9bYydBu6t+6a6PYNcZljzZR9VXg+4=
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
github.com/stretchr/testify v1.8.2/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
github.com/stretchr/testify v1.8.3 h1:RP3t2pwF7cMEbC1dqtB6poj3niw/9gnV4Cjg5oW5gtY=
github.com/stretchr/testify v1.8.3/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI=
github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
github.com/ugorji/go/codec v1.2.11 h1:BMaWp1Bb6fHwEtbplGBGJ498wD+LKlNSl25MjdZY4dU=
github.com/ugorji/go/codec v1.2.11/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
golang.org/x/arch v0.3.0 h1:02VY4/ZcO/gBOH6PUaoiptASxtXU10jazRCP865E97k=
golang.org/x/arch v0.3.0/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
golang.org/x/crypto v0.9.0 h1:LF6fAI+IutBocDJ2OT0Q1g8plpYljMZ4+lty+dsqw3g=
golang.org/x/crypto v0.9.0/go.mod h1:yrmDGqONDYtNj3tH8X9dzUun2m2lzPa9ngI6/RUPGR0=
golang.org/x/net v0.10.0 h1:X2//UzNDwYmtCLn7To6G58Wr6f5ahEAQgKNzv9Y951M=
golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg=
golang.org/x/sys v0.0.0-20220704084225-05e143d24a9e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
golang.org/x/sys v0.8.0 h1:EBmGv8NaZBZTWvrbjNoL6HVt+IVy3QDQpJs7VRIw3tU=
golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
golang.org/x/text v0.9.0 h1:2sjJmO8cDvYveuX97RDLsxlyUxLl+GHoLxBiRdHllBE=
golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8=
golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 h1:E7g+9GITq07hpfrRu66IVDexMakfv52eLZ2CXBWiKr4=
golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw=
google.golang.org/protobuf v1.30.0 h1:kPPoIgf3TsEvrm0PFe15JQ+570QVxYzEvvHqChK+cng=
google.golang.org/protobuf v1.30.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4=

291
handlers/fred.go Normal file
View File

@@ -0,0 +1,291 @@
package handlers
import (
"encoding/json"
"fmt"
"io"
"net/http"
"net/url"
"strconv"
"strings"
"fred-api/config"
"fred-api/models"
"github.com/gin-gonic/gin"
)
type FREDHandler struct {
baseURL string
apiKey string
}
func NewFREDHandler(cfg *config.Config) *FREDHandler {
return &FREDHandler{
baseURL: cfg.FREDBaseURL,
apiKey: cfg.FREDAPIKey,
}
}
func (h *FREDHandler) buildURL(endpoint string, params map[string]string) string {
u, _ := url.Parse(h.baseURL + endpoint)
query := u.Query()
query.Set("api_key", h.apiKey)
query.Set("file_type", "json")
for k, v := range params {
if v != "" {
query.Set(k, v)
}
}
u.RawQuery = query.Encode()
return u.String()
}
func (h *FREDHandler) fetchData(url string, target interface{}) error {
resp, err := http.Get(url)
if err != nil {
return err
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
return err
}
if resp.StatusCode != http.StatusOK {
var errResp models.ErrorResponse
json.Unmarshal(body, &errResp)
return fmt.Errorf("API error: %s - %s", errResp.ErrorCode, errResp.ErrorMessage)
}
return json.Unmarshal(body, target)
}
func (h *FREDHandler) GetSeries(c *gin.Context) {
seriesID := c.Query("series_id")
if seriesID == "" {
c.JSON(http.StatusBadRequest, models.ErrorResponse{
ErrorCode: "BadRequest",
ErrorMessage: "series_id is required",
})
return
}
params := map[string]string{
"series_id": seriesID,
}
if realtimeStart := c.Query("realtime_start"); realtimeStart != "" {
params["realtime_start"] = realtimeStart
}
if realtimeEnd := c.Query("realtime_end"); realtimeEnd != "" {
params["realtime_end"] = realtimeEnd
}
url := h.buildURL("/series", params)
var response models.SeriesListResponse
if err := h.fetchData(url, &response); err != nil {
c.JSON(http.StatusInternalServerError, models.ErrorResponse{
ErrorCode: "InternalError",
ErrorMessage: err.Error(),
})
return
}
c.JSON(http.StatusOK, response)
}
func (h *FREDHandler) GetObservations(c *gin.Context) {
seriesID := c.Query("series_id")
if seriesID == "" {
c.JSON(http.StatusBadRequest, models.ErrorResponse{
ErrorCode: "BadRequest",
ErrorMessage: "series_id is required",
})
return
}
params := map[string]string{
"series_id": seriesID,
}
optionalParams := []string{
"realtime_start", "realtime_end", "limit", "offset", "sort_order",
"observation_start", "observation_end", "units", "frequency",
"aggregation_method", "output_type", "vintage_dates",
}
for _, param := range optionalParams {
if v := c.Query(param); v != "" {
params[param] = v
}
}
url := h.buildURL("/series/observations", params)
var response models.ObservationsResponse
if err := h.fetchData(url, &response); err != nil {
c.JSON(http.StatusInternalServerError, models.ErrorResponse{
ErrorCode: "InternalError",
ErrorMessage: err.Error(),
})
return
}
c.JSON(http.StatusOK, response)
}
func (h *FREDHandler) SearchSeries(c *gin.Context) {
searchText := c.Query("search_text")
if searchText == "" {
c.JSON(http.StatusBadRequest, models.ErrorResponse{
ErrorCode: "BadRequest",
ErrorMessage: "search_text is required",
})
return
}
params := map[string]string{
"search_text": searchText,
}
optionalParams := []string{
"realtime_start", "realtime_end", "limit", "offset", "sort_order",
"observation_start", "observation_end", "units", "frequency",
"aggregation_method", "output_type",
}
for _, param := range optionalParams {
if v := c.Query(param); v != "" {
params[param] = v
}
}
url := h.buildURL("/series/search", params)
var response models.SearchResponse
if err := h.fetchData(url, &response); err != nil {
c.JSON(http.StatusInternalServerError, models.ErrorResponse{
ErrorCode: "InternalServerError",
ErrorMessage: err.Error(),
})
return
}
c.JSON(http.StatusOK, response)
}
func (h *FREDHandler) GetReleases(c *gin.Context) {
params := map[string]string{}
optionalParams := []string{
"realtime_start", "realtime_end", "limit", "offset", "sort_order",
}
for _, param := range optionalParams {
if v := c.Query(param); v != "" {
params[param] = v
}
}
url := h.buildURL("/releases", params)
var response models.ReleasesResponse
if err := h.fetchData(url, &response); err != nil {
c.JSON(http.StatusInternalServerError, models.ErrorResponse{
ErrorCode: "InternalServerError",
ErrorMessage: err.Error(),
})
return
}
c.JSON(http.StatusOK, response)
}
func (h *FREDHandler) GetReleaseDates(c *gin.Context) {
params := map[string]string{}
optionalParams := []string{
"realtime_start", "realtime_end", "limit", "offset", "sort_order",
"release_id", "date", "start_date", "end_date",
}
for _, param := range optionalParams {
if v := c.Query(param); v != "" {
params[param] = v
}
}
url := h.buildURL("/releases/dates", params)
var response models.ReleaseDatesResponse
if err := h.fetchData(url, &response); err != nil {
c.JSON(http.StatusInternalServerError, models.ErrorResponse{
ErrorCode: "InternalServerError",
ErrorMessage: err.Error(),
})
return
}
c.JSON(http.StatusOK, response)
}
func (h *FREDHandler) GetReleaseSeries(c *gin.Context) {
releaseIDStr := c.Query("release_id")
if releaseIDStr == "" {
c.JSON(http.StatusBadRequest, models.ErrorResponse{
ErrorCode: "BadRequest",
ErrorMessage: "release_id is required",
})
return
}
releaseID, err := strconv.Atoi(releaseIDStr)
if err != nil {
c.JSON(http.StatusBadRequest, models.ErrorResponse{
ErrorCode: "BadRequest",
ErrorMessage: "release_id must be a number",
})
return
}
params := map[string]string{
"release_id": strings.TrimSpace(strings.Replace(strconv.Itoa(releaseID), " ", "", -1)),
}
optionalParams := []string{
"realtime_start", "realtime_end", "limit", "offset", "sort_order",
"observation_start", "observation_end", "units", "frequency",
"aggregation_method", "output_type",
}
for _, param := range optionalParams {
if v := c.Query(param); v != "" {
params[param] = v
}
}
url := h.buildURL("/release/series", params)
var response models.SearchResponse
if err := h.fetchData(url, &response); err != nil {
c.JSON(http.StatusInternalServerError, models.ErrorResponse{
ErrorCode: "InternalServerError",
ErrorMessage: err.Error(),
})
return
}
c.JSON(http.StatusOK, response)
}
func (h *FREDHandler) HealthCheck(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{
"status": "healthy",
"service": "FRED API Proxy",
})
}

80
main.go Normal file
View File

@@ -0,0 +1,80 @@
package main
import (
"fmt"
"log"
"os"
"os/signal"
"syscall"
"fred-api/config"
"fred-api/handlers"
"github.com/gin-gonic/gin"
"github.com/joho/godotenv"
)
func main() {
if err := godotenv.Load(); err != nil {
log.Println("No .env file found, using default config")
}
cfg := config.Load()
fredHandler := handlers.NewFREDHandler(cfg)
gin.SetMode(gin.ReleaseMode)
router := gin.Default()
router.Use(func(c *gin.Context) {
c.Header("Access-Control-Allow-Origin", "*")
c.Header("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
c.Header("Access-Control-Allow-Headers", "Content-Type, Authorization")
if c.Request.Method == "OPTIONS" {
c.AbortWithStatus(204)
return
}
c.Next()
})
router.GET("/health", fredHandler.HealthCheck)
api := router.Group("/api/v1")
{
api.GET("/series", fredHandler.GetSeries)
api.GET("/series/observations", fredHandler.GetObservations)
api.GET("/series/search", fredHandler.SearchSeries)
api.GET("/releases", fredHandler.GetReleases)
api.GET("/releases/dates", fredHandler.GetReleaseDates)
api.GET("/release/series", fredHandler.GetReleaseSeries)
}
go func() {
fmt.Printf("FRED API Server starting on :%s\n", cfg.ServerPort)
fmt.Printf("FRED API Base URL: %s\n", cfg.FREDBaseURL)
fmt.Println("\nAvailable endpoints:")
fmt.Println(" GET /health - Health check")
fmt.Println(" GET /api/v1/series - Get series info")
fmt.Println(" GET /api/v1/series/observations - Get observations")
fmt.Println(" GET /api/v1/series/search - Search series")
fmt.Println(" GET /api/v1/releases - Get all releases")
fmt.Println(" GET /api/v1/releases/dates - Get release dates")
fmt.Println(" GET /api/v1/release/series - Get series in release")
fmt.Println("")
fmt.Println("Examples:")
fmt.Println(" curl 'http://localhost:" + cfg.ServerPort + "/api/v1/series?series_id=GNPCA'")
fmt.Println(" curl 'http://localhost:" + cfg.ServerPort + "/api/v1/series/observations?series_id=GNPCA&limit=10'")
fmt.Println(" curl 'http://localhost:" + cfg.ServerPort + "/api/v1/series/search?search_text=GDP'")
fmt.Println("")
if err := router.Run(":" + cfg.ServerPort); err != nil {
log.Fatalf("Failed to start server: %v", err)
}
}()
quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
fmt.Println("\nShutting down server...")
}

105
models/models.go Normal file
View File

@@ -0,0 +1,105 @@
package models
type Series struct {
ID string `json:"id"`
RealtimeStart string `json:"realtime_start"`
RealtimeEnd string `json:"realtime_end"`
Title string `json:"title"`
ObservationStart string `json:"observation_start"`
ObservationEnd string `json:"observation_end"`
Frequency string `json:"frequency"`
FrequencyShort string `json:"frequency_short"`
Units string `json:"units"`
UnitsShort string `json:"units_short"`
SeasonalAdjustment string `json:"seasonal_adjustment"`
SeasonalAdjustmentShort string `json:"seasonal_adjustment_short"`
LastUpdated string `json:"last_updated"`
Popularity int `json:"popularity"`
Notes string `json:"notes,omitempty"`
}
type SeriesListResponse struct {
RealtimeStart string `json:"realtime_start"`
RealtimeEnd string `json:"realtime_end"`
Seriess []Series `json:"seriess"`
}
type Observation struct {
RealtimeStart string `json:"realtime_start"`
RealtimeEnd string `json:"realtime_end"`
Date string `json:"date"`
Value string `json:"value"`
}
type ObservationsResponse struct {
RealtimeStart string `json:"realtime_start"`
RealtimeEnd string `json:"realtime_end"`
ObservationStart string `json:"observation_start"`
ObservationEnd string `json:"observation_end"`
Units string `json:"units"`
OutputType int `json:"output_type"`
FileType string `json:"file_type"`
OrderBy string `json:"order_by"`
SortOrder string `json:"sort_order"`
Count int `json:"count"`
Offset int `json:"offset"`
Limit int `json:"limit"`
Observations []Observation `json:"observations"`
}
type SearchResult struct {
ID string `json:"id"`
RealtimeStart string `json:"realtime_start"`
RealtimeEnd string `json:"realtime_end"`
Title string `json:"title"`
Frequency string `json:"frequency"`
Units string `json:"units"`
}
type SearchResponse struct {
RealtimeStart string `json:"realtime_start"`
RealtimeEnd string `json:"realtime_end"`
Count int `json:"count"`
Offset int `json:"offset"`
Limit int `json:"limit"`
OrderBy string `json:"order_by"`
SortOrder string `json:"sort_order"`
Results []SearchResult `json:"seriess"`
}
type Release struct {
ID int `json:"id"`
RealtimeStart string `json:"realtime_start"`
RealtimeEnd string `json:"realtime_end"`
Link string `json:"link"`
Name string `json:"name"`
PressRelease bool `json:"press_release"`
Notes string `json:"notes,omitempty"`
}
type ReleasesResponse struct {
RealtimeStart string `json:"realtime_start"`
RealtimeEnd string `json:"realtime_end"`
Count int `json:"count"`
Offset int `json:"offset"`
Limit int `json:"limit"`
Releases []Release `json:"releases"`
}
type ReleaseDatesResponse struct {
RealtimeStart string `json:"realtime_start"`
RealtimeEnd string `json:"realtime_end"`
Count int `json:"count"`
Offset int `json:"offset"`
Limit int `json:"limit"`
ReleaseDates []struct {
ReleaseID int `json:"release_id"`
Date string `json:"date"`
ReleaseName string `json:"release_name"`
} `json:"release_dates"`
}
type ErrorResponse struct {
ErrorCode string `json:"error_code"`
ErrorMessage string `json:"error_message"`
}

31
server.log Normal file
View File

@@ -0,0 +1,31 @@
2026/03/31 13:04:35 No .env file found, using default config
FRED API Server starting on :8080
FRED API Base URL: https://api.stlouisfed.org/fred
Available endpoints:
GET /health - Health check
GET /api/v1/series - Get series info
GET /api/v1/series/observations - Get observations
GET /api/v1/series/search - Search series
GET /api/v1/releases - Get all releases
GET /api/v1/releases/dates - Get release dates
GET /api/v1/release/series - Get series in release
Examples:
curl 'http://localhost:8080/api/v1/series?series_id=GNPCA'
curl 'http://localhost:8080/api/v1/series/observations?series_id=GNPCA&limit=10'
curl 'http://localhost:8080/api/v1/series/search?search_text=GDP'
[GIN] 2026/03/31 - 13:04:37 | 200 | 65.258µs | ::1 | GET "/health"
[GIN] 2026/03/31 - 13:26:20 | 200 | 54.616µs | ::1 | GET "/health"
[GIN] 2026/03/31 - 13:26:24 | 200 | 50.001µs | ::1 | GET "/health"
[GIN] 2026/03/31 - 13:26:26 | 200 | 357.800542ms | ::1 | GET "/api/v1/series?series_id=GNPCA"
[GIN] 2026/03/31 - 13:26:26 | 200 | 294.788721ms | ::1 | GET "/api/v1/series/observations?series_id=GNPCA&limit=5&sort_order=desc"
[GIN] 2026/03/31 - 13:26:29 | 200 | 2.612991796s | ::1 | GET "/api/v1/series/search?search_text=unemployment&limit=3"
[GIN] 2026/03/31 - 13:26:33 | 200 | 52.442µs | ::1 | GET "/health"
[GIN] 2026/03/31 - 13:26:34 | 200 | 326.98803ms | ::1 | GET "/api/v1/series?series_id=GNPCA"
[GIN] 2026/03/31 - 13:26:35 | 200 | 288.81544ms | ::1 | GET "/api/v1/series/observations?series_id=GNPCA&limit=5&sort_order=desc"
[GIN] 2026/03/31 - 13:26:41 | 500 | 1.001380921s | ::1 | GET "/api/v1/releases?limit=3"
[GIN] 2026/03/31 - 13:26:42 | 200 | 3.419214632s | ::1 | GET "/api/v1/series/search?search_text=unemployment%20rate&limit=3"
Shutting down server...

3
tests/go.mod Normal file
View File

@@ -0,0 +1,3 @@
module fred-api-test
go 1.21

88
tests/test_fred_api.go Normal file
View File

@@ -0,0 +1,88 @@
package main
import (
"encoding/json"
"fmt"
"io"
"net/http"
"net/url"
)
const (
APIKey = "987b9c3428a3d0fe90179e3e6298d05e"
BaseURL = "https://api.stlouisfed.org/fred"
)
func buildURL(endpoint string, params map[string]string) string {
u, _ := url.Parse(BaseURL + endpoint)
query := u.Query()
query.Set("api_key", APIKey)
query.Set("file_type", "json")
for k, v := range params {
if v != "" {
query.Set(k, v)
}
}
u.RawQuery = query.Encode()
return u.String()
}
func fetchAndPrint(endpoint string, params map[string]string) {
url := buildURL(endpoint, params)
fmt.Printf("\n=== Testing %s ===\n", endpoint)
fmt.Printf("URL: %s\n\n", url)
resp, err := http.Get(url)
if err != nil {
fmt.Printf("Error: %v\n", err)
return
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
fmt.Printf("Error reading body: %v\n", err)
return
}
var prettyJSON map[string]interface{}
if err := json.Unmarshal(body, &prettyJSON); err == nil {
output, _ := json.MarshalIndent(prettyJSON, "", " ")
fmt.Printf("Response:\n%s\n", output)
} else {
fmt.Printf("Response:\n%s\n", string(body))
}
}
func main() {
fmt.Println("========================================")
fmt.Println(" FRED API 测试脚本")
fmt.Println("========================================")
fetchAndPrint("/series", map[string]string{"series_id": "GNPCA"})
fetchAndPrint("/series/observations", map[string]string{
"series_id": "GNPCA",
"limit": "5",
"observation_end": "2000-01-01",
})
fetchAndPrint("/series/search", map[string]string{
"search_text": "GDP",
"limit": "3",
})
fetchAndPrint("/releases", map[string]string{
"limit": "3",
})
fetchAndPrint("/releases/dates", map[string]string{
"limit": "3",
"start_date": "2026-03-01",
"end_date": "2026-03-31",
})
fmt.Println("\n========================================")
fmt.Println(" 测试完成!")
fmt.Println("========================================")
}