checks

Check a token before buying it

Is this token safe to buy? Simulates a buy and sell-back through the token's real pool (at your trade size, if given), reads what its creator can still do (mint, hidden mint, pause, upgrade), who can pull the liquidity, the holders, and whether the creator was paid by a wallet behind earlier rugs. A signed allow, caution or block, an action and the reasons. Costs $0.03 a call over x402, in USDC on Base (eip155:8453). Charged only when an answer is given; or call it with a free API key (100 checks a day: https://lorglabs.com/get-a-key.html). Read action in the answer.

post/v1/check/token

Request

  • Base URL: https://api.lorglabs.com
  • URL: https://api.lorglabs.com/v1/check/token
  • Auth: one of:
    • none
    • HTTP bearer

Request body

chain'base' | 'ethereum' required

The chain the address is on. A chain ID is accepted too (8453 or eip155:8453 for base, 1 or eip155:1 for ethereum).

addressstring required

The token's contract address: 0x followed by 40 hex characters.

context'swap' | 'pay' | 'hold'

Optional: what you are about to do. Echoed back in the answer; it doesn't change the checks.

amount_usdnumber

Optional: the size of the trade you intend, in US dollars. The check then also buys and sells that amount in simulation, and says so (EXIT_LIQUIDITY_INSUFFICIENT, action limit_exposure) when the pool is too small for it or the token limits the size of a sale. Give it whenever you know the size.

Response

The answer, signed.

request_idstring required

This request's id; it is inside the signed body.

verdict'allow' | 'caution' | 'block' required
risk_scoreinteger required
confidence'high' | 'medium' | 'low' required
action'proceed' | 'limit_exposure' | 'do_not_proceed' required

What to do: the field an agent acts on.

summarystring required

One plain sentence that can be shown to a person.

address_type'wallet' | 'delegated_wallet' | 'contract' | 'unknown'
walletobject

A wallet's history (quick check).

tokenobject

Token check: name, symbol, age, launchpad, the main pool, the simulated round trip, and the sized trade when amount_usd was given.

checks_runstring[] required
checks_failedstring[] required

Checks that could not be completed. An answer with failed checks is never allow on their account.

chainstring required
addressstring required
contextstring
amount_usdnumber
blockinteger nullable

The block the answer was computed at.

as_ofstring date-time required
rulesetstring required
cachedboolean required

Served from a short cache (at most 30 s for most tokens); as_of says when it was computed.

Changes

No recorded changes to this operation across all 1 revision of this API.