BluebulbAPI
    API reference/Rates
    GET

    Get a currency pair rate

    Rolling out
    GET{baseUrl}/api/rates?fromCurrency={from}&toCurrency={to}

    Returns the current rate for one currency pair, including the sell side and when the rate took effect.

    This endpoint is part of an API release that is still rolling out. Fields and endpoints marked Rolling out may not be available on your account yet.

    Authentication

    Send your API key and a request signature on every call. Requests must also come from an IP address on your allowlist — see Authentication.

    Headers

    x-api-key
    required
    string
    Your API key, <appId>.<secret>. See Authentication.
    X-Signature
    required
    string
    Base64 RSA-SHA256 signature of the request. See Request signing.
    X-Signature-Timestamp
    required
    string
    Unix time in milliseconds used in the signature. Must be within 5 minutes of Orbita's clock.

    Query parameters

    fromCurrency
    required
    string
    Currency to convert from. Lowercase currency code, e.g. ngn, usd, gbp.
    toCurrency
    required
    string
    Currency to convert to. Lowercase currency code, e.g. ngn, usd, gbp.

    Behaviour

    Send both currencies or neither. Sending only one is rejected with 400; sending neither lists every rate (see List rates).

    The rate is returned in the direction you ask for: buyRate is fromCurrency → toCurrency and sellRate the reverse.

    A same-currency pair (e.g. usd → usd) returns buyRate and sellRate of 1.

    A pair Orbita doesn't offer returns 400 naming the pair.

    Response

    data is a single rate object. Every response is wrapped in the standard envelope.

    pair
    string
    The pair in upper case, e.g. USD/NGN.
    fromCurrency
    string
    Currency you convert from.
    toCurrency
    string
    Currency you convert to.
    buyRate
    number
    Rate for converting fromCurrency → toCurrency, as people quote it. For NGN pairs it's naira per unit of the other currency — e.g. 1550 for usd→ngn (₦1,550 for each $1 you convert). For other pairs it's toCurrency per 1 fromCurrency, e.g. 1.08 for eur→usd.
    sellRate
    number | null
    Rate for the opposite direction (toCurrency → fromCurrency), quoted the same way for that direction. For NGN pairs it's also naira per unit, so it compares directly with buyRate — e.g. 1600 for ngn→usd (₦1,600 for each $1). For other pairs it's fromCurrency per 1 toCurrency. If Orbita isn't currently offering that direction, this is the last recorded rate and you can't convert at it; null when there's none.
    rateTimestamp
    string (datetime)
    When this rate took effect.
    validUntil
    string (datetime) | null
    Expiry of this specific rate. null for general market rates, which have no fixed expiry.

    Errors

    Errors specific to this endpoint:

    400
    Provide both fromCurrency and toCurrency to look up a specific pair, or neither to list all rates
    Only one of the two currencies was sent.
    400
    No rate found for usd to kes
    Orbita doesn't currently offer the pair.
    400
    Validation failed
    A currency code isn't recognised (codes must be lowercase).

    Plus the errors every endpoint can return — authentication, signing, rate limiting and server errors. See Responses & errors.