Token pre-trade check API for Solana and Base

One call before an agent buys a token or pays a counterparty: token safety verdict, OFAC screen of the wallet and the token's authorities, and the wallet's pay-readiness, combined into GO, CAUTION or STOP with plain reasons.

A trading agent about to buy a token usually needs three answers: is the token safe, is anyone involved on a sanctions list, and can my wallet actually pay. GET /bundle/token-pre-trade gets all three in one call and gives you one decision: GO, CAUTION or STOP.

What it combines

Token safety: the Solana token verdict for a mint, or the Base token verdict for a 0x token. That covers authorities, Token-2022 traps, liquidity, sell route and holders.
OFAC screen of the counterparty wallet, the token address and the token's mint, freeze and update authorities (Solana) or owner (Base). It uses the official Treasury lists, as in the sanctions screen.
Wallet pay-readiness for an optional wallet on Base or Solana: USDC and gas balances, whether it can pay amount, shortfalls, frozen or blacklisted USDC and open approvals. It's the same check as wallet pay-readiness.

The rules: STOP if any address is on the OFAC list, the token is rated avoid (or graded D or F on Base), or the wallet cannot pay. CAUTION if the token is rated caution, the wallet needs review (for example an unlimited approval), or a part is unavailable. Otherwise GO.

Example

GET /bundle/token-pre-trade?token=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&wallet=0x6d7be981c103eD360874a7703ad3CD6a98929aFB&amount=0.01

Trimmed real response on Nov 11, 2026 (BONK, paid from our Base wallet):

{
  "decision": "GO",
  "reasons": [
    "GO: token verdict safe (A)",
    "GO: no OFAC match for 2 address(es) (wallet, mint)",
    "GO: wallet can pay 0.01 USDC"
  ],
  "token": { "chain": "solana", "symbol": "Bonk", "level": "GO" },
  "sanctions": { "screened": 2, "matches": 0, "sdnPublishDate": "2026-11-09" },
  "wallet": { "chain": "base", "status": "ok", "canPay": { "x402": true } },
  "pricing": { "packUsd": 0.025, "separateCallsUsd": 0.05 }
}

Price and payment

$0.025 per call over x402, in USDC on Base or Solana. The same checks bought separately cost $0.03 to $0.07, depending on how many addresses are screened. If the input is bad, or the token is not a real mint or contract, you get a 400 or 422 before any payment. The route is also a tool called token_pre_trade on the remote MCP server.

What it does not do

Each part is a heuristic, read-only check. It is not a security audit, legal or compliance advice, or investment advice. A GO means none of these checks found a problem, not that the trade is safe.

Try it free

Get a free API key (100 calls a month, no card), then pass it in the x-api-key header. This route uses 1 call of the monthly quota.

curl -X POST https://signals.incomefather.com/billing/free \
  -H 'content-type: application/json' -d '{"email":"you@example.com"}'

curl -H "x-api-key: $TRADING_SIGNALS_API_KEY" \
  "https://signals.incomefather.com/bundle/token-pre-trade?token=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&wallet=0x6d7be981c103eD360874a7703ad3CD6a98929aFB&amount=0.01"

Agents that hold a wallet can skip the key entirely and pay per call over x402 (see x402 pay-per-call market data). Copy-paste code for curl, JavaScript, Python, MCP (Claude Desktop, Cursor, Cline), LangChain and the OpenAI Agents SDK is in gdietsch/trading-signals-examples.