ephemeral

Developers · API v0

Build on ephemeral

A public, read-only API for quote previews, token market info, and health. Non-custodial: this API never holds a key and never signs or sends a transaction. You sign in your own wallet.

Request access OpenAPI spec curl examples

API v0

Served under /api/v1. Responses include version: "v0". Breaking changes will ship under a new path. CORS is open for these read endpoints. Rate limit: 60 requests per minute per client (5 access requests per 10 minutes).

MethodPathWhat it returns
GET/api/v1/healthLiveness, custody and signing posture, feature flags.
GET/api/v1/quoteSwap quote preview. The platform fee is a computed amount in the output mint.
GET/api/v1/feesFee policy. Fees appear as amounts on quotes. No schedule is published here.
GET/api/v1/token/{mint}Public market info for a Solana mint.
GET/api/v1/openapi.jsonOpenAPI 3 description of this API.
POST/api/v1/keys/requestRequest access. Collects name, email, project, and intended use only.

Fees on quotes

Call /api/v1/quote with inputMint, outputMint, and amount (base units). The response includes a fee object with a computed amount and the mint it is denominated in. This API does not publish a fee or revenue schedule. Integrators can attach a referral when they go live; details follow after access is reviewed.

Integrator program

Revenue share for integrators. If you are building a bot, launchpad, extension, or terminal on this API, request access and we will follow up with terms. No secret is issued automatically.

Webhooks

Signed webhooks are coming soon. They are not available in API v0. GET /api/v1/webhooks returns that status.

Request API access

Tell us who you are and what you are building. We only store the fields below. We do not issue a secret in this form, and you should never send a key or seed here.

Examples

Replace the mints and amount for your pair. These calls are read-only.

curl -sS "https://feed.ephemeral.money/api/v1/health"

curl -sS "https://feed.ephemeral.money/api/v1/quote?inputMint=So11111111111111111111111111111111111111112&outputMint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=100000000"

curl -sS "https://feed.ephemeral.money/api/v1/token/So11111111111111111111111111111111111111112"

curl -sS "https://feed.ephemeral.money/api/v1/openapi.json"

Rules