Skip to main content
POST
Want to attach take-profit, stop-loss, trailing, time, or dev-sell exits via the auto_orders field? See the Auto-orders guide for the full field reference, the target_value table, and examples.

Authorizations

​
Authorization
string
header
required

Your Bloom API key, e.g. Authorization: Bearer blm_sol_live_…. Create one in Bloom Manager → Manage API Keys.

Body

application/json
​
address
string
required

Token mint address or pool ID.

​
side
enum<string>
required
Available options:
Buy,
Sell
​
priority_fee
number
required

Priority fee. Denominated in SOL on the Solana host and in gwei on the EVM host — see Fee denomination.

​
processor_tip
number
required

Processor tip; ignored when auto_tip is true. Denominated in SOL on the Solana host and in the chain's native asset on the EVM host.

​
slippage
number
required

Slippage tolerance as a percentage, e.g. 10 = 10%.

​
anti_mev
boolean
required
​
auto_tip
boolean
required

When true, the server sets the priority fee and processor tip for you.

​
wallets
object[]
required
Minimum array length: 1
​
chain
enum<string>

EVM host only. The chain to trade on, matched case-insensitively. Optional — when omitted, the token address is resolved across the supported chains automatically. Pass it explicitly to pin the lookup to one chain. An unrecognised value fails with INVALID_REQUEST. Not used on the Solana host. See Chains and quote assets.

Available options:
eth,
bsc,
base,
rbh,
arc
​
sell_mode
enum<string>
default:percent

For a Sell, how each wallet's amount is interpreted: percent (1-100 of holdings, the default) or tokens (absolute token quantity). An over-amount in tokens mode sells the full balance. Ignored for a Buy. tokens is Solana-only — the EVM host rejects it with INVALID_REQUEST.

Available options:
percent,
tokens
​
auto_orders
object[]

Attach take-profit / stop-loss / trailing / time / dev-sell exits to this swap (up to 20; any beyond 20 are dropped). See the Auto-orders guide for the full field reference, the target_value table, and examples.

Maximum array length: 20
​
quote_asset
enum<string>

Quote asset to trade against — what a Buy spends, and the unit of wallets[].amount. Omit it to use the chain's native token.

Each chain's native token is named by its own symbol: SOL on the Solana host, and on EVM ETH (eth, base, rbh), BNB (bsc) or USDC (arc, whose native token is USDC).

Support is validated per chain — eth USDC/USDT, bsc USD1/USDC/USDT, base USDC, rbh USDG, arc native only, Solana USDC/USD1. An asset the chain does not support is rejected with INVALID_REQUEST, and the error lists the valid set. See Chains and quote assets.

Available options:
SOL,
ETH,
BNB,
USDC,
USDT,
USD1,
USDG
​
min_liquidity
number

Pool liquidity bounds in USD.

​
max_liquidity
number

Pool liquidity bounds in USD.

​
min_market_cap
number

Token market-cap bounds in USD.

​
max_market_cap
number

Token market-cap bounds in USD.

Response

Swap accepted.

​
success
boolean
required
Example:

true

​
data
object
required