Repository Public
1// SP Wallet Core2// File: Sources/SPWalletCore/Domains/Execution/MarketsAPI.swift3// Description: READ-ONLY endpoints of the market explorer, the venue comparator, the private-company contracts and the4// consolidated market data. Nothing here places, prepares or signs anything.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8import Foundation910public struct MarketsAPI: Sendable {11 let client: APIClient12 public init(_ client: APIClient) { self.client = client }1314 // MARK: markets hub1516 public func list(_ q: HubQuery = HubQuery()) async throws -> HubList {17 let search = q.search.map { String($0.trimmingCharacters(in: .whitespaces).prefix(40)) }.flatMap { $0.isEmpty ? nil : $0 }18 return try await client.get("/markets-hub", query: ["kind": q.kind, "venue": q.venue, "category": q.category, "q": search, "tradable": q.tradable.map { $0 ? "yes" : "no" },19 "sort": q.sort.rawValue, "dir": q.descending ? "desc" : "asc", "limit": String(min(max(q.limit, 1), 500)), "offset": String(min(max(q.offset, 0), 100_000))])20 }2122 public func underlyings() async throws -> [HubUnderlying] {23 struct R: Decodable, Sendable { let underlyings: [HubUnderlying] }24 return try await client.get("/markets-hub/underlyings", as: R.self).underlyings25 }2627 /** Every market of one underlying (a ticker of 1–15 letters or digits), spot and perpetual, venue by venue. */28 public func underlying(_ symbol: String) async throws -> HubUnderlyingDetail { try await client.get("/markets-hub/underlyings/\(APIClient.segment(symbol))") }2930 /** The estimated cost of ONE position across venues. An estimate under the assumptions the answer states. */31 public func compare(_ q: CompareQuery) async throws -> VenueComparison {32 let c: VenueComparison = try await client.get("/markets-hub/compare", query: ["underlying": q.underlying, "side": q.side, "notional": q.notional, "leverage": q.leverage, "horizonHours": q.horizonHours,33 "liquidity": q.liquidity, "minNetEdgeBps": q.minNetEdgeBps])34 guard c.underlying.uppercased() == q.underlying.uppercased() else { throw ApprovalError.inconsistent("the comparison answered is for another underlying") }35 return c36 }3738 // MARK: private markets (display only)3940 private static func positionQuery(size: String?, side: String?) -> [String: String?] { ["size": size, "side": side] }4142 /** `delisted: true` lists ONLY delisted contracts. `size`/`side`: the hypothetical position of the exposure figure. */43 public func privateMarkets(delisted: Bool = false, size: String? = nil, side: String? = nil) async throws -> PrivateMarketList {44 var q = Self.positionQuery(size: size, side: side); q["delisted"] = delisted ? "true" : nil45 return try await client.get("/private-markets", query: q)46 }4748 public func privateCompany(slug: String, size: String? = nil, side: String? = nil) async throws -> PrivateCompanyDetail {49 try await client.get("/private-markets/companies/\(APIClient.segment(slug))", query: Self.positionQuery(size: size, side: side))50 }5152 /** `interval`: `1h` or `1d`; `limit`: 1…500 candles. */53 public func privateMarket(id: String, size: String? = nil, side: String? = nil, interval: String? = nil, limit: Int? = nil) async throws -> PrivateMarketDetail {54 var q = Self.positionQuery(size: size, side: side); q["interval"] = interval; q["limit"] = limit.map { String(min(max($0, 1), 500)) }55 let d: PrivateMarketDetail = try await client.get("/private-markets/\(APIClient.segment(id))", query: q)56 guard d.market.id == id else { throw ApprovalError.inconsistent("the contract answered is another one") }57 return d58 }5960 // MARK: consolidated market data6162 public func marketDataStatus() async throws -> MarketDataStatus { try await client.get("/market-data/status") }6364 /** Closed bars of the consolidated series. `until`: unix ms, bars up to it. */65 public func candles(symbol: String, interval: String, limit: Int = 500, until: Int? = nil) async throws -> MarketCandles {66 let c: MarketCandles = try await client.get("/market-data/candles", query: ["symbol": symbol, "interval": interval, "limit": String(min(max(limit, 1), 5000)), "until": until.map(String.init)])67 guard c.symbol.uppercased() == symbol.uppercased(), c.interval == interval else { throw ApprovalError.inconsistent("the series answered is another one") }68 return c69 }70}71