GET /boost/quote/{md5}
GET

/v1/boost/quote/{md5}

Get quote for boosting a token

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/boost/quote/0dd550278b74cb6690fdae351e8e0df3
Path parameterValueDescription
md5The token's md5 (md5 of issuer_currency)
Query parameterValueDescription
rankint
termHoursint, a multiple of 12: also prices this length
curl 'https://api.xrpl.to/v1/boost/quote/0dd550278b74cb6690fdae351e8e0df3'

Response

200Example response69 ms · just now · 6.5 KB · 260 lines
https://api.xrpl.to/v1/boost/quote/0dd550278b74cb6690fdae351e8e0df3
{
  "token": {
    "md5": "0dd550278b74cb6690fdae351e8e0df3",
    "name": "RLUSD",
    "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000"
  },
  "current": null,
  "auction": {
    "slots": 10,
    "filled": 0,
    "termHours": 12,
    "terms": [
      {
        "hours": 12,
        "label": "12h"
      },
      {
        "hours": 24,
        "label": "24h"
      },
      {
        "hours": 72,
        "label": "3 days"
      },
      {
        "hours": 168,
        "label": "7 days"
      },
      {
        "hours": 720,
        "label": "30 days"
      }
    ],
    "maxHours": 8760,
    "longRunSlots": 8,
    "longRunsFull": false,
    "protectHours": 2,
    "featuredSlots": 5,
    "floorUsd": 5,
    "outbidPct": 0.1,
    "minBidUsd": 5,
    "minBidXrp": 5.35,
    "opensAt": null,
    "board": []
  },
  "tiers": [
    {
      "id": "rail",
      "name": "Rail",
      "priceUsd": 5,
      "blurb": "A place on the sponsored rail, ranked by bid",
      "priceXrp": 5.35,
      "terms": [
        {
          "hours": 12,
          "label": "12h",
          "priceUsd": 5,
          "priceXrp": 5.35,
          "endsAt": "2026-11-22T05:33:03.176Z",
          "protectedUntil": "2026-11-21T19:33:03.176Z"
        },
        {
          "hours": 24,
          "label": "24h",
          "priceUsd": 10,
          "priceXrp": 10.7,
          "endsAt": "2026-11-22T17:33:03.176Z",
          "protectedUntil": "2026-11-22T05:33:03.176Z"
        },
        {
          "hours": 72,
          "label": "3 days",
          "priceUsd": 30,
          "priceXrp": 32.1,
          "endsAt": "2026-11-24T17:33:03.176Z",
          "protectedUntil": "2026-11-24T05:33:03.176Z"
        },
        {
          "hours": 168,
          "label": "7 days",
          "priceUsd": 70,
          "priceXrp": 74.88,
          "endsAt": "2026-11-28T17:33:03.176Z",
          "protectedUntil": "2026-11-28T05:33:03.176Z"
        },
        {
          "hours": 720,
          "label": "30 days",
          "priceUsd": 300,
          "priceXrp": 320.91,
          "endsAt": "2026-12-21T17:33:03.176Z",
          "protectedUntil": "2026-12-21T05:33:03.176Z"
        }
      ]
    },
    {
      "id": "featured",
      "name": "Featured",
      "priceUsd": 5,
      "blurb": "Top 5 — also on the homepage rail",
      "priceXrp": 5.35,
      "terms": [
        {
          "hours": 12,
          "label": "12h",
          "priceUsd": 5,
          "priceXrp": 5.35,
          "endsAt": "2026-11-22T05:33:03.176Z",
          "protectedUntil": "2026-11-21T19:33:03.176Z"
        },
        {
          "hours": 24,
          "label": "24h",
          "priceUsd": 10,
          "priceXrp": 10.7,
          "endsAt": "2026-11-22T17:33:03.176Z",
          "protectedUntil": "2026-11-22T05:33:03.176Z"
        },
        {
          "hours": 72,
          "label": "3 days",
          "priceUsd": 30,
          "priceXrp": 32.1,
          "endsAt": "2026-11-24T17:33:03.176Z",
          "protectedUntil": "2026-11-24T05:33:03.176Z"
        },
        {
          "hours": 168,
          "label": "7 days",
          "priceUsd": 70,
          "priceXrp": 74.88,
          "endsAt": "2026-11-28T17:33:03.176Z",
          "protectedUntil": "2026-11-28T05:33:03.176Z"
        },
        {
          "hours": 720,
          "label": "30 days",
          "priceUsd": 300,
          "priceXrp": 320.91,
          "endsAt": "2026-12-21T17:33:03.176Z",
          "protectedUntil": "2026-12-21T05:33:03.176Z"
        }
      ]
    },
    {
      "id": "ad",
      "name": "Ad slot",
      "priceUsd": 10,
      "blurb": "Top 3 — your sponsored link across the site; outbid #3 to take it",
      "priceXrp": 10.7,
      "terms": [
        {
          "hours": 12,
          "label": "12h",
          "priceUsd": 10,
          "priceXrp": 10.7,
          "endsAt": "2026-11-22T05:33:03.176Z",
          "protectedUntil": "2026-11-21T19:33:03.176Z"
        },
        {
          "hours": 24,
          "label": "24h",
          "priceUsd": 20,
          "priceXrp": 21.4,
          "endsAt": "2026-11-22T17:33:03.176Z",
          "protectedUntil": "2026-11-22T05:33:03.176Z"
        },
        {
          "hours": 72,
          "label": "3 days",
          "priceUsd": 60,
          "priceXrp": 64.19,
          "endsAt": "2026-11-24T17:33:03.176Z",
          "protectedUntil": "2026-11-24T05:33:03.176Z"
        },
        {
          "hours": 168,
          "label": "7 days",
          "priceUsd": 140,
          "priceXrp": 149.76,
          "endsAt": "2026-11-28T17:33:03.176Z",
          "protectedUntil": "2026-11-28T05:33:03.176Z"
        },
        {
          "hours": 720,
          "label": "30 days",
          "priceUsd": 600,
          "priceXrp": 641.82,
          "endsAt": "2026-12-21T17:33:03.176Z",
          "protectedUntil": "2026-12-21T05:33:03.176Z"
        }
      ]
    },
    {
      "id": "top",
      "name": "Top spot",
      "priceUsd": 10,
      "blurb": "Rank 1 — first on every rail, plus your sponsored link across the site",
      "priceXrp": 10.7,
      "terms": [
        {
          "hours": 12,
          "label": "12h",
          "priceUsd": 10,
          "priceXrp": 10.7,
          "endsAt": "2026-11-22T05:33:03.176Z",
          "protectedUntil": "2026-11-21T19:33:03.176Z"
        },
        {
          "hours": 24,
          "label": "24h",
          "priceUsd": 20,
          "priceXrp": 21.4,
          "endsAt": "2026-11-22T17:33:03.176Z",
          "protectedUntil": "2026-11-22T05:33:03.176Z"
        },
        {
          "hours": 72,
          "label": "3 days",
          "priceUsd": 60,
          "priceXrp": 64.19,
          "endsAt": "2026-11-24T17:33:03.176Z",
          "protectedUntil": "2026-11-24T05:33:03.176Z"
        },
        {
          "hours": 168,
          "label": "7 days",
          "priceUsd": 140,
          "priceXrp": 149.76,
          "endsAt": "2026-11-28T17:33:03.176Z",
          "protectedUntil": "2026-11-28T05:33:03.176Z"
        },
        {
          "hours": 720,
          "label": "30 days",
          "priceUsd": 600,
          "priceXrp": 641.82,
          "endsAt": "2026-12-21T17:33:03.176Z",
          "protectedUntil": "2026-12-21T05:33:03.176Z"
        }
      ]
    }
  ],
  "extend": null,
  "ad": {
    "site": "ripple.com",
    "approved": true,
    "reserveUsd": 10,
    "clicks7d": 0,
    "textMax": 70,
    "ctaMax": 14,
    "ctaDefault": "Visit site",
    "current": null
  },
  "xrpUsd": 0.93485,
  "pricing": {
    "feeCollector": "rBMrq2GN521SbDyRbnwJc3nVBwxnXRpLTo",
    "network": "mainnet"
  }
}

What it does

Get quote for boosting a token

How the slot auction works is in the Boost guide. Read the guide →
OpenAPI