Marketly Assistant by Binomo icon

Marketly Assistant Data API: signals, deals and balances

Seadragon · Banking

Marketly Assistant by Binomo is Seadragon's Android client for the Binomo short-term trading platform, used by retail traders across Asia, Latin America, Africa and the Middle East. A single app carries a signal feed with trend direction and expiry times, candle charts for 75+ assets, real, demo and tournament accounts with stake sizing and payout rates, cashback rewards, deposit bonuses, purchasable trading strategies and Hall-of-Fame leaderboards. Deposits and withdrawals run through a country-specific payment-method catalogue, and a separate prediction-market section prices event contracts by probability. Binomo has operated since 2014 and claims 3M+ active traders across 130+ countries; this build ships as com.marketly.trading version 8.5.0.

Trading-signal rows keyed by asset_ric pair a direction in trend with actual_before and expire_at timestamps, giving researchers an asset and a time window to align with OHLC candles. Candle rows carry created_at, open, high, low and close. The instrument catalogue resolves the asset through ric, name and type, while per-user payment_rate_turbo and payment_rate_standard values apply between start_time and end_time. Open-deal records add a trade identifier in uuid, the referenced asset_ric, stake in amount, entry quote in open_rate and payout rate in payment_rate. Outcome-related fields include win and close_rate; the latter can remain null on an open trade.

Account-side rows complement the market data: balance, currency_iso, required_turnover and inactive_fee_date describe available funds and account conditions, while ledger entries classify DEAL, BUY, INACTIVE_FEE, REFUND or REWARD changes through type, change and date. Profiles add deposits_sum and status_group, and funding transaction items carry amount, status and currency_iso. Cashback records provide guid, percent, available_at and expired_at; country-specific payment methods add payment_system, commission and maintenance. Strategy offers expose benefit_type, name and price, while owned strategies are identified by name.

Leaderboard records separate max_win_rate, max_turnover and max_deals_count boards, with nickname, country_iso, position and value inside a window bounded by begin_at_inclusive and end_at_exclusive. Prediction-event records connect event_id to nested market_id values and add chance, contract_price, opens_at and closes_at. The market list retains the parent event reference, status and market_data, with next_cursor for continuing the collection.

Signal aggregators can compare directional calls with candle prices by asset and expiry window, fee-comparison tools can line up instrument payout rates with country-specific payment commissions, and trading-analytics teams can compare deals, dated ledger changes and funding transactions. A trade's uuid is not listed in the ledger fields, so ledger type and date alone do not establish a unique trade match. Reward-alert tools can use the cashback availability and expiry timestamps to schedule reminders. openData Studio turns these records into callable open data so integration teams can build these tools without scraping screens.

Screenshots

  • Marketly Assistant by Binomo screenshot 1
  • Marketly Assistant by Binomo screenshot 2
  • Marketly Assistant by Binomo screenshot 3
  • Marketly Assistant by Binomo screenshot 4

API surface

The endpoints and request/response examples below are reconstructed from the app's interface — illustrative, not a live capture.

  • Trading signals feed

    GET /illustrative/v1/market-study/signal-feed opendata

    Returns the signal feed for one asset or all assets: the trend direction, the moment the call was issued in actual_before and the expiry the trade must be closed by in expire_at.

    Auth: Authorization-Token header carrying the Binomo session token for authenticated calls. Unauthenticated calls carry an App-Info header instead.

    • data
    • id
    • asset_ric
    • trend
    • actual_before
    • expire_at
    GET /illustrative/v1/market-study/signal-feed?data%5Bfilter%5D%5Basset_ric%5D=EURUSD HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": [
        {
          "id": "sig_8f21c",
          "asset_ric": "EURUSD",
          "trend": "UP",
          "actual_before": "2026-10-25T09:42:00Z",
          "expire_at": "2026-10-25T09:47:00Z"
        }
      ]
    }
  • Candles by asset and frame

    GET /illustrative/v1/market-study/price-bars opendata

    Returns the OHLC candle series for one asset, anchored at a datetime and sampled at a frame in seconds, so a client can rebuild the chart behind a trade.

    Auth: Authorization-Token header with the session token.

    • data
    • created_at
    • open
    • high
    • low
    • close
    GET /illustrative/v1/market-study/price-bars?asset_ric=EURUSD&datetime=2026-10-25T09%3A00%3A00Z&frame=60 HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": [
        {
          "created_at": "2026-10-25T09:00:00Z",
          "open": 1.08342,
          "high": 1.08391,
          "low": 1.08317,
          "close": 1.08378
        }
      ]
    }
  • Tradable asset catalogue

    GET /illustrative/v1/market-study/instrument-directory opendata

    Lists the instruments the account can trade with their RIC symbol, display name, asset type, icon and the per-user turbo and standard payout rates that apply in the current time window.

    Auth: Authorization-Token header with the session token.

    • data
    • assets
    • id
    • name
    • ric
    • type
    • icon.url
    • trading_tools_settings
    • personal_user_payment_rates
    • payment_rate_turbo
    • payment_rate_standard
    • start_time
    • end_time
    GET /illustrative/v1/market-study/instrument-directory HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": {
        "assets": [
          {
            "id": 1042,
            "name": "EUR/USD",
            "ric": "EURUSD",
            "type": 1,
            "icon": {
              "url": "<RESOURCE_URL>"
            },
            "trading_tools_settings": {
              "turbo": true,
              "range": false
            },
            "personal_user_payment_rates": [
              {
                "payment_rate_turbo": 82,
                "payment_rate_standard": 74,
                "start_time": "2026-10-25T00:00:00Z",
                "end_time": "2026-10-25T23:59:59Z"
              }
            ]
          }
        ]
      }
    }
  • Account profile

    GET /illustrative/v1/market-study/trader-profile openbanking

    Reads the signed-in trader's profile: account currency, status group, cumulative deposits, country of record and the news opt-in flag.

    Auth: Authorization-Token header with the session token.

    • data
    • currency
    • status_group
    • deposits_sum
    • country
    • country_name
    • receive_news
    GET /illustrative/v1/market-study/trader-profile HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": {
        "currency": "USD",
        "status_group": "advanced",
        "deposits_sum": 420000,
        "country": "IN",
        "country_name": "India",
        "receive_news": true
      }
    }
  • Trading balance

    GET /illustrative/v1/market-study/available-funds openbanking

    Returns the real-account balance plus the turnover still required on the account and the date an inactivity fee would begin to apply.

    Auth: Authorization-Token header with the session token.

    • data
    • balance
    • currency_iso
    • required_turnover
    • inactive_fee_date
    GET /illustrative/v1/market-study/available-funds HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": {
        "balance": 128450,
        "currency_iso": "USD",
        "required_turnover": 640000,
        "inactive_fee_date": "2027-01-25T00:00:00Z"
      }
    }
  • Balance ledger

    GET /illustrative/v1/market-study/balance-events openbanking

    Pages the balance ledger for one event type, returning dated amount changes and the anchor needed to fetch the next page.

    Auth: Authorization-Token header with the session token.

    • data
    • content
    • pagination_anchor
    • type
    • date
    • change
    GET /illustrative/v1/market-study/balance-events?page_size=50&event_type=DEAL&pagination_anchor=1682304000 HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": {
        "content": [
          {
            "type": "DEAL",
            "date": "2026-10-24T18:12:04Z",
            "change": -5000
          }
        ],
        "pagination_anchor": "1682304000"
      }
    }
  • Transaction list

    GET /illustrative/v1/market-study/funding-activity openbanking

    Pages deposit, withdrawal and adjustment transactions with date, type, status and repeatability filters; the items array carries the amount, currency and lifecycle state of each record.

    Auth: Authorization-Token header with the session token.

    • data
    • items
    • id
    • display_name
    • created_at
    • type
    • amount
    • status
    • currency_iso
    GET /illustrative/v1/market-study/funding-activity?page=1&per=20&date_from=2026-10-01&date_to=2026-10-25&type=deposit&status=completed HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": {
        "items": [
          {
            "id": "tx_77120",
            "display_name": "Visa deposit",
            "created_at": 1761300000,
            "type": "deposit",
            "amount": 100000,
            "status": "completed",
            "currency_iso": "USD"
          }
        ]
      }
    }
  • Cashback rewards

    GET /illustrative/v1/market-study/reward-credits openfinance

    Lists the trader's cashback rewards with amount, percentage, lifecycle status and the dates the reward becomes available and expires.

    Auth: Authorization-Token header with the session token.

    • data
    • guid
    • amount
    • currency_iso
    • percent
    • status
    • available_at
    • expired_at
    GET /illustrative/v1/market-study/reward-credits HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": [
        {
          "guid": "cb_5c11e8",
          "amount": 1200,
          "currency_iso": "USD",
          "percent": 10,
          "status": "available",
          "available_at": "2026-10-24T00:00:00Z",
          "expired_at": "2026-11-07T00:00:00Z"
        }
      ]
    }
  • Payment-method catalogue

    GET /illustrative/v1/market-study/funding-rails openfinance

    Returns deposit methods grouped by payment type for a country, with each method's commission, maintenance flag and payment_system key used to open the checkout.

    Auth: Authorization-Token header with the session token.

    • data
    • type
    • icon
    • name
    • methods
    • id
    • label
    • title
    • payment_system
    • icons
    • maintenance
    • commission
    GET /illustrative/v1/market-study/funding-rails?country_iso=IN HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": [
        {
          "type": "card",
          "icon": "<ICON_URL>",
          "name": "Cards",
          "methods": [
            {
              "id": 41,
              "label": "visa_mc",
              "title": "Visa / Mastercard",
              "payment_system": "visa_mc",
              "icons": {
                "light": "<LIGHT_ICON_URL>",
                "dark": "<DARK_ICON_URL>"
              },
              "maintenance": false,
              "commission": 0.0
            }
          ]
        }
      ]
    }
  • Active deals

    GET /illustrative/v1/market-study/open-positions openfinance

    Lists currently open trades on the real, demo or tournament account: stake, entry quote, payout rate, direction, option type and the asset RIC each trade references.

    Auth: Authorization-Token header with the session token.

    • data
    • standard_trade_deals
    • uuid
    • asset_ric
    • asset_name
    • amount
    • status
    • deal_type
    • created_at
    • open_quote_created_at
    • open_rate
    • payment
    • payment_rate
    • win
    • trend
    • option_type
    • tournament_id
    • close_rate
    GET /illustrative/v1/market-study/open-positions?type=real HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": {
        "standard_trade_deals": [
          {
            "uuid": "dl_3a87f0",
            "asset_ric": "EURUSD",
            "asset_name": "EUR/USD",
            "amount": 5000,
            "status": "OPENED",
            "deal_type": "trade",
            "created_at": "2026-10-25T09:40:12Z",
            "open_quote_created_at": "2026-10-25T09:40:12Z",
            "open_rate": 1.08342,
            "payment": 4100,
            "payment_rate": 82,
            "win": 0,
            "trend": "UP",
            "option_type": "turbo",
            "tournament_id": null,
            "close_rate": null
          }
        ]
      }
    }
  • Benefits and strategy catalogue

    GET /illustrative/v1/market-study/strategy-offers openfinance

    Lists the bonus and trading-strategy products available to the account, with the benefit type, identifier, display name and price.

    Auth: Authorization-Token header with the session token.

    • data
    • benefit_type
    • id
    • name
    • price
    GET /illustrative/v1/market-study/strategy-offers HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": [
        {
          "benefit_type": "STRATEGY",
          "id": "easy_60_seconds",
          "name": "Easy 60 Seconds",
          "price": 2500
        }
      ]
    }
  • Purchased strategies

    GET /illustrative/v1/market-study/owned-strategies openfinance

    Returns the trading strategies the account already owns, keyed by strategy name; each name resolves to a downloadable strategy file.

    Auth: Authorization-Token header with the session token.

    • data
    • name
    GET /illustrative/v1/market-study/owned-strategies HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": [
        {
          "name": "easy_60_seconds"
        },
        {
          "name": "medium_stochastic_rsi"
        }
      ]
    }
  • Hall-of-fame leaderboards

    GET /illustrative/v1/market-study/trader-rankings opendata

    Returns three ranked trader boards for the current window, by deal count, win rate and turnover, with nickname, country and board value for each position.

    Auth: Authorization-Token header with the session token.

    • data
    • begin_at_inclusive
    • end_at_exclusive
    • next_end_at_exclusive
    • max_deals_count
    • max_win_rate
    • max_turnover
    • user_id
    • country_iso
    • position
    • nickname
    • value
    GET /illustrative/v1/market-study/trader-rankings HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": {
        "begin_at_inclusive": "2026-10-18T00:00:00Z",
        "end_at_exclusive": "2026-10-25T00:00:00Z",
        "next_end_at_exclusive": "2026-11-01T00:00:00Z",
        "max_deals_count": [
          {
            "user_id": "u_9012",
            "country_iso": "BR",
            "position": 1,
            "nickname": "trader_br",
            "value": 412.0
          }
        ],
        "max_win_rate": [
          {
            "user_id": "u_7741",
            "country_iso": "IN",
            "position": 1,
            "nickname": "niftyfox",
            "value": 0.87
          }
        ],
        "max_turnover": [
          {
            "user_id": "u_3388",
            "country_iso": "ID",
            "position": 1,
            "nickname": "sultan_pips",
            "value": 98120.0
          }
        ]
      }
    }
  • Prediction events

    GET /illustrative/v1/market-study/prediction-rounds opendata

    Lists prediction-market events with their market legs, live probability in chance, contract price and the timestamps when the event opens and closes.

    Auth: Authorization-Token header with the session token.

    • data
    • event_id
    • title
    • series_title
    • image_url
    • status
    • category
    • opens_at
    • closes_at
    • contract_price
    • markets
    • market_id
    • chance
    • updated_at
    • market_data
    GET /illustrative/v1/market-study/prediction-rounds HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": [
        {
          "event_id": "ev_2210",
          "title": "Will BTC close above 70k this week?",
          "series_title": "Crypto weekly",
          "image_url": "<IMAGE_URL>",
          "status": "OPEN",
          "category": "crypto",
          "opens_at": "2026-10-20T00:00:00Z",
          "closes_at": "2026-10-27T00:00:00Z",
          "contract_price": 100,
          "markets": [
            {
              "market_id": "mk_881",
              "title": "Above 70k",
              "chance": 0.63,
              "updated_at": "2026-10-25T09:41:00Z",
              "market_data": {
                "best_bid": 61,
                "best_ask": 65
              }
            }
          ]
        }
      ]
    }
  • Prediction markets

    GET /illustrative/v1/market-study/prediction-contracts opendata

    Pages prediction markets with their parent event, status, open and close times, quoted market data and the cursor needed to fetch the next page.

    Auth: Authorization-Token header with the session token.

    • data
    • markets
    • next_cursor
    • meta.next_cursor
    • market_id
    • market_title
    • event_id
    • event_title
    • event_series_title
    • image_url
    • status
    • opens_at
    • closes_at
    • event_markets_count
    • market_data
    • token
    GET /illustrative/v1/market-study/prediction-contracts?limit=50&statuses=OPEN&next_cursor=eyJpZCI6ODgxfQ HTTP/1.1
    Authorization-Token: <session_token>
    Accept: application/json
    {
      "data": {
        "markets": [
          {
            "market_id": "mk_881",
            "market_title": "BTC above 70k this week",
            "event_id": "ev_2210",
            "event_title": "Will BTC close above 70k this week?",
            "event_series_title": "Crypto weekly",
            "image_url": "<IMAGE_URL>",
            "status": "OPEN",
            "opens_at": "2026-10-20T00:00:00Z",
            "closes_at": "2026-10-27T00:00:00Z",
            "event_markets_count": 2,
            "market_data": {
              "best_bid": 61,
              "best_ask": 65
            },
            "token": "<TOKEN>"
          }
        ],
        "next_cursor": "eyJpZCI6ODgyfQ"
      },
      "meta": {
        "next_cursor": "eyJpZCI6ODgyfQ"
      }
    }

Data categories

  • trading signals
  • OHLC candles
  • tradable assets
  • account profile
  • account balance
  • balance ledger
  • transactions
  • cashback rewards
  • payment methods
  • open deals
  • benefits and strategies
  • leaderboards
  • prediction events
  • prediction markets

Where teams use this data

  • Signal hit-rate backtesting

    Join each asset_ric and trend from the signal feed with actual_before and expire_at, then align it to the candle series via created_at, open, high, low and close to score how often a directional call resolved in the money per expiry frame.

  • Payout and fee comparison

    Compare payment_rate_turbo and payment_rate_standard per asset against payment_system, commission and maintenance in the payment catalogue, so a comparison site can show the true cost of a trade and a deposit by country_iso.

  • Deal and ledger reconciliation

    Match open and closed deals (uuid, open_rate, payment_rate, win, close_rate) against balance-history rows (type, date, change) and transaction items (amount, status, currency_iso) to reconcile trading profit and loss with deposits, withdrawals, refunds and fees.

  • Cashback and bonus lifecycle alerts

    Track cashback guid, percent, status, available_at and expired_at together with benefit_type, name and price so a bot can remind a trader before a reward expires or a strategy purchase window closes.

Frequently asked questions

Can a trade be matched uniquely to a balance-ledger entry?

Open deals carry uuid, asset_ric, deal_type and status, with amount, open_rate, payment_rate, win and close_rate describing the trade. The ledger lists type, date and change, but no deal uuid, so those ledger fields alone do not establish a unique trade-level match. The asset catalogue's ric can be compared with asset_ric to resolve the instrument's name and type.

What session authentication is described for the data?

The listed authenticated operations use a Binomo session token in the Authorization-Token header. The signal-feed description also distinguishes unauthenticated calls that carry App-Info. The endpoint table illustrates this request structure; it does not provide a session token.

Which fields support signal and candle comparisons?

Signals include asset_ric, trend, actual_before and expire_at. Candle queries select an asset, datetime anchor and frame in seconds; each returned bar carries created_at, open, high, low and close. Analytics teams can align the selected asset and time window to compare a directional signal with price movement. Such a comparison is not itself a settled-trade result.

Which prediction-event and market fields are available?

Event records include event_id, title, status, contract_price, opens_at and closes_at, with nested markets carrying market_id, chance, updated_at and market_data. The paginated market list links market_id to event_id and includes market_title, event_title, status, market_data and next_cursor. These event and market records do not document position quantities or realized profit and loss.

Apps similar to Marketly Assistant by Binomo

  • IQ Option – Trading Platform — IQ Option is an online platform whose homepage advertises CFD trading on stocks, forex and cryptocurrencies.
  • Olymptrade – Trading online — Olymptrade is a licensed online broker with Fixed Time, Forex and Stocks modes, plus Flex and InZone tickets, over 180 instruments, and a refillable demo account of 10,000 virtual units.
  • Pocket Option — Pocket Option is a web and Android trading desk for currencies, commodities and stocks across more than 100 assets, with a virtual-funds practice account plus copy and social trading.
  • Deriv — Deriv is an online broker, operating since 1999, that offers CFDs and options on forex, stocks, indices, commodities, cryptocurrencies, ETFs and 24/7 synthetic indices, with Deriv MT5, cTrader and a zero-risk demo account.
  • MetaTrader 5 — Forex, Stocks — MetaTrader 5 is MetaQuotes' trading platform for forex, stocks and futures, with desktop, WebTerminal and Android clients; MetaQuotes itself does not provide brokerage services.
  • ExpertOption — ExpertOption is an online investing and trading service that lists 100 assets and stocks, a free demo, and clients for Android 4.4 and higher.

Topics

  • Marketly Assistant Data API
  • Binomo trading data
  • trading signals API
  • candle OHLC data
  • trading deals fields
  • account balance history
  • prediction markets API
  • payment method data

Need this app's data API integrated?

We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.

  • NDA + SOW on every engagement
  • Delivery in 3–7 days
  • Payment only after acceptance
  • Work scoped to authorized use

Get a quote