XRPL.to
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 response55 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": 3.99,
    "opensAt": null,
    "board": []
  },
  "tiers": [
    {
      "id": "rail",
      "name": "Rail",
      "priceUsd": 5,
      "blurb": "A place on the sponsored rail, ranked by bid",
      "priceXrp": 3.99,
      "terms": [
        {
          "hours": 12,
          "label": "12h",
          "priceUsd": 5,
          "priceXrp": 3.99,
          "endsAt": "2026-11-01T19:04:39.638Z",
          "protectedUntil": "2026-11-01T09:04:39.638Z"
        },
        {
          "hours": 24,
          "label": "24h",
          "priceUsd": 10,
          "priceXrp": 7.98,
          "endsAt": "2026-11-02T07:04:39.638Z",
          "protectedUntil": "2026-11-01T19:04:39.638Z"
        },
        {
          "hours": 72,
          "label": "3 days",
          "priceUsd": 30,
          "priceXrp": 23.94,
          "endsAt": "2026-11-04T07:04:39.638Z",
          "protectedUntil": "2026-11-03T19:04:39.638Z"
        },
        {
          "hours": 168,
          "label": "7 days",
          "priceUsd": 70,
          "priceXrp": 55.85,
          "endsAt": "2026-11-08T07:04:39.638Z",
          "protectedUntil": "2026-11-07T19:04:39.638Z"
        },
        {
          "hours": 720,
          "label": "30 days",
          "priceUsd": 300,
          "priceXrp": 239.36,
          "endsAt": "2026-12-01T07:04:39.638Z",
          "protectedUntil": "2026-11-30T19:04:39.638Z"
        }
      ]
    },
    {
      "id": "featured",
      "name": "Featured",
      "priceUsd": 5,
      "blurb": "Top 5 — also on the homepage rail",
      "priceXrp": 3.99,
      "terms": [
        {
          "hours": 12,
          "label": "12h",
          "priceUsd": 5,
          "priceXrp": 3.99,
          "endsAt": "2026-11-01T19:04:39.638Z",
          "protectedUntil": "2026-11-01T09:04:39.638Z"
        },
        {
          "hours": 24,
          "label": "24h",
          "priceUsd": 10,
          "priceXrp": 7.98,
          "endsAt": "2026-11-02T07:04:39.638Z",
          "protectedUntil": "2026-11-01T19:04:39.638Z"
        },
        {
          "hours": 72,
          "label": "3 days",
          "priceUsd": 30,
          "priceXrp": 23.94,
          "endsAt": "2026-11-04T07:04:39.638Z",
          "protectedUntil": "2026-11-03T19:04:39.638Z"
        },
        {
          "hours": 168,
          "label": "7 days",
          "priceUsd": 70,
          "priceXrp": 55.85,
          "endsAt": "2026-11-08T07:04:39.638Z",
          "protectedUntil": "2026-11-07T19:04:39.638Z"
        },
        {
          "hours": 720,
          "label": "30 days",
          "priceUsd": 300,
          "priceXrp": 239.36,
          "endsAt": "2026-12-01T07:04:39.638Z",
          "protectedUntil": "2026-11-30T19:04:39.638Z"
        }
      ]
    },
    {
      "id": "ad",
      "name": "Ad slot",
      "priceUsd": 10,
      "blurb": "Top 3 — your sponsored link across the site; outbid #3 to take it",
      "priceXrp": 7.98,
      "terms": [
        {
          "hours": 12,
          "label": "12h",
          "priceUsd": 10,
          "priceXrp": 7.98,
          "endsAt": "2026-11-01T19:04:39.638Z",
          "protectedUntil": "2026-11-01T09:04:39.638Z"
        },
        {
          "hours": 24,
          "label": "24h",
          "priceUsd": 20,
          "priceXrp": 15.96,
          "endsAt": "2026-11-02T07:04:39.638Z",
          "protectedUntil": "2026-11-01T19:04:39.638Z"
        },
        {
          "hours": 72,
          "label": "3 days",
          "priceUsd": 60,
          "priceXrp": 47.88,
          "endsAt": "2026-11-04T07:04:39.638Z",
          "protectedUntil": "2026-11-03T19:04:39.638Z"
        },
        {
          "hours": 168,
          "label": "7 days",
          "priceUsd": 140,
          "priceXrp": 111.7,
          "endsAt": "2026-11-08T07:04:39.638Z",
          "protectedUntil": "2026-11-07T19:04:39.638Z"
        },
        {
          "hours": 720,
          "label": "30 days",
          "priceUsd": 600,
          "priceXrp": 478.72,
          "endsAt": "2026-12-01T07:04:39.638Z",
          "protectedUntil": "2026-11-30T19:04:39.638Z"
        }
      ]
    },
    {
      "id": "top",
      "name": "Top spot",
      "priceUsd": 10,
      "blurb": "Rank 1 — first on every rail, plus your sponsored link across the site",
      "priceXrp": 7.98,
      "terms": [
        {
          "hours": 12,
          "label": "12h",
          "priceUsd": 10,
          "priceXrp": 7.98,
          "endsAt": "2026-11-01T19:04:39.638Z",
          "protectedUntil": "2026-11-01T09:04:39.638Z"
        },
        {
          "hours": 24,
          "label": "24h",
          "priceUsd": 20,
          "priceXrp": 15.96,
          "endsAt": "2026-11-02T07:04:39.638Z",
          "protectedUntil": "2026-11-01T19:04:39.638Z"
        },
        {
          "hours": 72,
          "label": "3 days",
          "priceUsd": 60,
          "priceXrp": 47.88,
          "endsAt": "2026-11-04T07:04:39.638Z",
          "protectedUntil": "2026-11-03T19:04:39.638Z"
        },
        {
          "hours": 168,
          "label": "7 days",
          "priceUsd": 140,
          "priceXrp": 111.7,
          "endsAt": "2026-11-08T07:04:39.638Z",
          "protectedUntil": "2026-11-07T19:04:39.638Z"
        },
        {
          "hours": 720,
          "label": "30 days",
          "priceUsd": 600,
          "priceXrp": 478.72,
          "endsAt": "2026-12-01T07:04:39.638Z",
          "protectedUntil": "2026-11-30T19:04:39.638Z"
        }
      ]
    }
  ],
  "extend": null,
  "ad": {
    "site": "ripple.com",
    "approved": true,
    "reserveUsd": 10,
    "clicks7d": 0,
    "textMax": 70,
    "ctaMax": 14,
    "ctaDefault": "Visit site",
    "current": null
  },
  "xrpUsd": 1.2533599999999998,
  "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
NextPOST/boost/purchase