Lists not yet paid out posts ranked by amount spent on promotion (order within the same promotion is newer first).
Aside from different post format routine is the same as bridge.get_ranked_posts with promoted sort.

method: "condenser_api.get_discussions_by_promoted"
params:
{
  "start_author":"{author}", "start_permlink":"{permlink}",

    start_author + start_permlink : optional, when given have to point to valid start post; paging mechanism (cuts out this and more promoted posts)

  "limit":{number},

    optional, 1..100, default = 20

  "tag":"{tag}",

    optional, turns on filtering for posts with given tag; when community tag is used it filters for community posts
    (compared to original version, posts that are only tagged with community tag, but don't belong to community, are no longer put in results)

  "truncate_body":{number}

    optional, default = 0 (meaning no truncation); reduces maximal size of post body, cutting out all excess

  "filter_tags":[{list_of_tags}]

    has to be left empty, not supported
}