Placeholder
The /placeholder endpoint generates SVG placeholders: simple images or animated skeleton loaders.
curl -X GET \ "https://api.moxon.dev/v5/placeholder"Send the request to see the response here.
type"image" | "skeleton"required
—imageorskeletonwidthnumberoptionalWidth in pixels (1–4000)
Default:
800.heightnumberoptionalHeight in pixels (1–4000)
Default:
600.bgstringoptionalBackground color (hex)
Default:
#cccccc/#e5e5e5.colorstringoptionalText / highlight color (hex)
Default:
#333333/#f5f5f5.textstringoptionalDisplayed text (
imageonly)Default:
800×600.rowsnumberoptionalNumber of lines (
skeletononly, 0–20)Default:
3.avatarstringoptionalAvatar shape:
—circle,rounded,squareortrue- true
- circle
- rounded
- square
linesnumberoptionalText lines next to avatar (
skeletononly)Default:
2.animate"shimmer" | "pulse" | "none"optionalAnimation:
shimmer,pulse,noneDefault:
shimmer.speednumberoptionalAnimation speed (0.1–10)
Default:
1.5.radiusnumberoptionalBorder radius of blocks (0–50)
Default:
4.
Good to know
The bg and color defaults differ between types: image uses #cccccc/#333333, skeleton uses #e5e5e5/#f5f5f5.
The response is an image/svg+xml file for both types.
If parameters are missing or invalid, the API will return an error:
- 400
Type must be one of: image, skeletonThetypeparameter is invalid - 400
width must be a numberWidth is not a valid number - 400
width must be between 1 and 4000Width is out of range - 400
Invalid color (use hex like #ff6600)A color parameter is malformed - 400
avatar must be one of: circle, rounded, squareInvalid avatar shape - 400
animate must be one of: shimmer, pulse, noneInvalid animation mode - 400
speed must be between 0.1 and 10Speed is out of range - 400
radius must be between 0 and 50Radius is out of range
Last updated on May 25, 2026