2025-03-17 11:54:53 -04:00
|
|
|
class Provider::Synth < Provider
|
|
|
|
include ExchangeRate::Provideable
|
|
|
|
include Security::Provideable
|
2024-03-27 09:16:00 -06:00
|
|
|
|
2024-07-08 09:04:59 -04:00
|
|
|
def initialize(api_key)
|
|
|
|
@api_key = api_key
|
2024-05-27 18:10:28 +02:00
|
|
|
end
|
|
|
|
|
2024-08-16 12:13:48 -04:00
|
|
|
def healthy?
|
2025-03-17 11:54:53 -04:00
|
|
|
provider_response do
|
|
|
|
response = client.get("#{base_url}/user")
|
|
|
|
JSON.parse(response.body).dig("id").present?
|
|
|
|
end
|
2024-08-16 12:13:48 -04:00
|
|
|
end
|
2024-10-30 18:08:19 -04:00
|
|
|
|
2024-10-02 12:07:56 -04:00
|
|
|
def usage
|
2025-03-17 11:54:53 -04:00
|
|
|
provider_response do
|
|
|
|
response = client.get("#{base_url}/user")
|
2024-10-02 12:07:56 -04:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
parsed = JSON.parse(response.body)
|
2024-10-02 12:07:56 -04:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
remaining = parsed.dig("api_calls_remaining")
|
|
|
|
limit = parsed.dig("api_limit")
|
|
|
|
used = limit - remaining
|
2024-08-16 12:13:48 -04:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
UsageData.new(
|
|
|
|
used: used,
|
|
|
|
limit: limit,
|
|
|
|
utilization: used.to_f / limit * 100,
|
|
|
|
plan: parsed.dig("plan"),
|
|
|
|
)
|
2024-08-01 19:43:23 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
# ================================
|
|
|
|
# Exchange Rates
|
|
|
|
# ================================
|
|
|
|
|
2024-03-27 09:16:00 -06:00
|
|
|
def fetch_exchange_rate(from:, to:, date:)
|
2025-03-17 11:54:53 -04:00
|
|
|
provider_response retries: 2 do
|
2024-08-05 12:21:12 -04:00
|
|
|
response = client.get("#{base_url}/rates/historical") do |req|
|
2024-03-27 09:16:00 -06:00
|
|
|
req.params["date"] = date.to_s
|
|
|
|
req.params["from"] = from
|
|
|
|
req.params["to"] = to
|
|
|
|
end
|
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
rates = JSON.parse(response.body).dig("data", "rates")
|
|
|
|
|
|
|
|
ExchangeRate::Provideable::FetchRateData.new(
|
|
|
|
rate: ExchangeRate.new(
|
|
|
|
from_currency: from,
|
|
|
|
to_currency: to,
|
|
|
|
date: date,
|
|
|
|
rate: rates.dig(to)
|
|
|
|
)
|
|
|
|
)
|
2024-03-27 09:16:00 -06:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2024-08-09 16:57:33 +02:00
|
|
|
def fetch_exchange_rates(from:, to:, start_date:, end_date:)
|
2025-03-17 11:54:53 -04:00
|
|
|
provider_response retries: 1 do
|
|
|
|
data = paginate(
|
|
|
|
"#{base_url}/rates/historical-range",
|
|
|
|
from: from,
|
|
|
|
to: to,
|
|
|
|
date_start: start_date.to_s,
|
|
|
|
date_end: end_date.to_s
|
|
|
|
) do |body|
|
|
|
|
body.dig("data")
|
2024-08-09 16:57:33 +02:00
|
|
|
end
|
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
ExchangeRate::Provideable::FetchRatesData.new(
|
|
|
|
rates: data.paginated.map do |exchange_rate|
|
|
|
|
ExchangeRate.new(
|
|
|
|
from_currency: from,
|
|
|
|
to_currency: to,
|
|
|
|
date: exchange_rate.dig("date"),
|
|
|
|
rate: exchange_rate.dig("rates", to)
|
|
|
|
)
|
|
|
|
end
|
|
|
|
)
|
|
|
|
end
|
2024-08-09 16:57:33 +02:00
|
|
|
end
|
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
# ================================
|
|
|
|
# Securities
|
|
|
|
# ================================
|
|
|
|
|
|
|
|
def search_securities(symbol, country_code: nil, exchange_operating_mic: nil)
|
|
|
|
provider_response do
|
|
|
|
response = client.get("#{base_url}/tickers/search") do |req|
|
|
|
|
req.params["name"] = symbol
|
|
|
|
req.params["dataset"] = "limited"
|
|
|
|
req.params["country_code"] = country_code if country_code.present?
|
|
|
|
req.params["exchange_operating_mic"] = exchange_operating_mic if exchange_operating_mic.present?
|
|
|
|
req.params["limit"] = 25
|
|
|
|
end
|
2024-10-30 09:23:44 -04:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
parsed = JSON.parse(response.body)
|
|
|
|
|
|
|
|
Security::Provideable::Search.new(
|
|
|
|
securities: parsed.dig("data").map do |security|
|
|
|
|
Security.new(
|
|
|
|
ticker: security.dig("symbol"),
|
|
|
|
name: security.dig("name"),
|
|
|
|
logo_url: security.dig("logo_url"),
|
|
|
|
exchange_acronym: security.dig("exchange", "acronym"),
|
|
|
|
exchange_mic: security.dig("exchange", "mic_code"),
|
|
|
|
exchange_operating_mic: security.dig("exchange", "operating_mic_code"),
|
|
|
|
country_code: security.dig("exchange", "country_code")
|
|
|
|
)
|
|
|
|
end
|
|
|
|
)
|
2024-10-30 09:23:44 -04:00
|
|
|
end
|
2025-03-17 11:54:53 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
def fetch_security_info(security)
|
|
|
|
provider_response do
|
|
|
|
response = client.get("#{base_url}/tickers/#{security.ticker}") do |req|
|
|
|
|
req.params["mic_code"] = security.exchange_mic if security.exchange_mic.present?
|
|
|
|
req.params["operating_mic"] = security.exchange_operating_mic if security.exchange_operating_mic.present?
|
|
|
|
end
|
|
|
|
|
|
|
|
data = JSON.parse(response.body).dig("data")
|
2024-10-30 09:23:44 -04:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
Security::Provideable::SecurityInfo.new(
|
|
|
|
ticker: security.ticker,
|
|
|
|
name: data.dig("name"),
|
|
|
|
links: data.dig("links"),
|
|
|
|
logo_url: data.dig("logo_url"),
|
|
|
|
description: data.dig("description"),
|
|
|
|
kind: data.dig("kind")
|
|
|
|
)
|
|
|
|
end
|
2024-10-30 09:23:44 -04:00
|
|
|
end
|
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
def fetch_security_price(security, date:)
|
|
|
|
provider_response do
|
|
|
|
historical_data = fetch_security_prices(security, start_date: date, end_date: date)
|
|
|
|
|
|
|
|
raise ProviderError, "No prices found for security #{security.ticker} on date #{date}" if historical_data.data.prices.empty?
|
|
|
|
|
|
|
|
Security::Provideable::PriceData.new(
|
|
|
|
price: historical_data.data.prices.first
|
|
|
|
)
|
2024-10-30 18:08:19 -04:00
|
|
|
end
|
2025-03-17 11:54:53 -04:00
|
|
|
end
|
2024-10-30 18:08:19 -04:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
def fetch_security_prices(security, start_date:, end_date:)
|
|
|
|
provider_response retries: 1 do
|
|
|
|
params = {
|
|
|
|
start_date: start_date,
|
|
|
|
end_date: end_date
|
|
|
|
}
|
|
|
|
|
|
|
|
params[:operating_mic_code] = security.exchange_operating_mic if security.exchange_operating_mic.present?
|
|
|
|
|
|
|
|
data = paginate(
|
|
|
|
"#{base_url}/tickers/#{security.ticker}/open-close",
|
|
|
|
params
|
|
|
|
) do |body|
|
|
|
|
body.dig("prices")
|
|
|
|
end
|
2024-10-30 18:08:19 -04:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
currency = data.first_page.dig("currency")
|
|
|
|
country_code = data.first_page.dig("exchange", "country_code")
|
|
|
|
exchange_mic = data.first_page.dig("exchange", "mic_code")
|
|
|
|
exchange_operating_mic = data.first_page.dig("exchange", "operating_mic_code")
|
|
|
|
|
|
|
|
Security::Provideable::PricesData.new(
|
|
|
|
prices: data.paginated.map do |price|
|
|
|
|
Security::Price.new(
|
|
|
|
security: security,
|
|
|
|
date: price.dig("date"),
|
|
|
|
price: price.dig("close") || price.dig("open"),
|
|
|
|
currency: currency
|
|
|
|
)
|
|
|
|
end
|
|
|
|
)
|
|
|
|
end
|
2024-10-30 18:08:19 -04:00
|
|
|
end
|
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
# ================================
|
|
|
|
# Transactions
|
|
|
|
# ================================
|
|
|
|
|
2024-12-13 17:22:27 -05:00
|
|
|
def enrich_transaction(description, amount: nil, date: nil, city: nil, state: nil, country: nil)
|
2025-03-17 11:54:53 -04:00
|
|
|
provider_response do
|
|
|
|
params = {
|
|
|
|
description: description,
|
|
|
|
amount: amount,
|
|
|
|
date: date,
|
|
|
|
city: city,
|
|
|
|
state: state,
|
|
|
|
country: country
|
|
|
|
}.compact
|
2024-12-13 17:22:27 -05:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
response = client.get("#{base_url}/enrich", params)
|
2024-12-13 17:22:27 -05:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
parsed = JSON.parse(response.body)
|
2024-12-13 17:22:27 -05:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
TransactionEnrichmentData.new(
|
2024-12-13 17:22:27 -05:00
|
|
|
name: parsed.dig("merchant"),
|
|
|
|
icon_url: parsed.dig("icon"),
|
|
|
|
category: parsed.dig("category")
|
2025-03-17 11:54:53 -04:00
|
|
|
)
|
|
|
|
end
|
2024-12-13 17:22:27 -05:00
|
|
|
end
|
|
|
|
|
2024-03-27 09:16:00 -06:00
|
|
|
private
|
|
|
|
attr_reader :api_key
|
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
TransactionEnrichmentData = Data.define(:name, :icon_url, :category)
|
|
|
|
|
|
|
|
def retryable_errors
|
|
|
|
[
|
|
|
|
Faraday::TimeoutError,
|
|
|
|
Faraday::ConnectionFailed,
|
|
|
|
Faraday::SSLError,
|
|
|
|
Faraday::ClientError,
|
|
|
|
Faraday::ServerError
|
|
|
|
]
|
|
|
|
end
|
2024-03-27 09:16:00 -06:00
|
|
|
|
|
|
|
def base_url
|
2024-11-25 23:17:00 +08:00
|
|
|
ENV["SYNTH_URL"] || "https://api.synthfinance.com"
|
2024-03-27 09:16:00 -06:00
|
|
|
end
|
|
|
|
|
2024-08-05 12:21:12 -04:00
|
|
|
def app_name
|
|
|
|
"maybe_app"
|
|
|
|
end
|
|
|
|
|
|
|
|
def app_type
|
|
|
|
Rails.application.config.app_mode
|
|
|
|
end
|
|
|
|
|
|
|
|
def client
|
|
|
|
@client ||= Faraday.new(url: base_url) do |faraday|
|
2025-03-17 11:54:53 -04:00
|
|
|
faraday.response :raise_error
|
2024-08-05 12:21:12 -04:00
|
|
|
faraday.headers["Authorization"] = "Bearer #{api_key}"
|
|
|
|
faraday.headers["X-Source"] = app_name
|
|
|
|
faraday.headers["X-Source-Type"] = app_type
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2024-08-01 19:43:23 -04:00
|
|
|
def fetch_page(url, page, params = {})
|
2025-03-17 11:54:53 -04:00
|
|
|
client.get(url, params.merge(page: page))
|
2024-08-01 19:43:23 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
def paginate(url, params = {})
|
|
|
|
results = []
|
|
|
|
page = 1
|
|
|
|
current_page = 0
|
|
|
|
total_pages = 1
|
2025-03-17 11:54:53 -04:00
|
|
|
first_page = nil
|
2024-08-01 19:43:23 -04:00
|
|
|
|
|
|
|
while current_page < total_pages
|
|
|
|
response = fetch_page(url, page, params)
|
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
body = JSON.parse(response.body)
|
|
|
|
first_page = body unless first_page
|
|
|
|
page_results = yield(body)
|
|
|
|
results.concat(page_results)
|
2024-08-01 19:43:23 -04:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
current_page = body.dig("paging", "current_page")
|
|
|
|
total_pages = body.dig("paging", "total_pages")
|
2024-08-01 19:43:23 -04:00
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
page += 1
|
2024-08-01 19:43:23 -04:00
|
|
|
end
|
|
|
|
|
2025-03-17 11:54:53 -04:00
|
|
|
PaginatedData.new(
|
|
|
|
paginated: results,
|
|
|
|
first_page: first_page,
|
|
|
|
total_pages: total_pages
|
|
|
|
)
|
2024-08-01 19:43:23 -04:00
|
|
|
end
|
2024-03-27 09:16:00 -06:00
|
|
|
end
|