SPB Git

Repository Public

MarketsAPI.swift 4.5 KB 71 lines swift

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
Files main
Menu

Theme