API v1

frong.ai API

Operational

Read wallet statistics from the public database or submit wallets for fresh processing. No API key is required.

Databasehttps://api.frong.ai

Processing/upload/

Quick start

Fetch 25 wallets with at least $10,000 profit and a 60% win rate.

cURL

curl "https://api.frong.ai/v1/wallets?per_page=25&min_profit=10000&min_winrate=60&fields=address,total_profit,winrate_30d"

Database API

Stored wallet data

Responses are JSON. List requests support pagination, projection, sorting, and filters.

GET /v1/wallets List and filter wallets ›

Returns a paginated wallet collection and pagination metadata.

GET /v1/wallets?sort_by=total_profit&order=desc&fdv_only=true

View all query parameters →

GET /v1/wallets/{address} Get one wallet ›

Returns the latest stored snapshot for one exact 0x address. Returns 404 if it is not stored.

GET /v1/wallets/0x59050e6c37ed6bdd003966af9b061757c7f04757?fields=address,total_profit

GET /v1/summary Database totals and freshness ›

Returns total wallets, FDV-enriched wallets, profitable wallets, and the latest update timestamp.

GET /v1/fields Field catalog ›

Returns every public field with its type, description, and sorting/filtering support.

Processing API

Fresh wallet processing

Processing is asynchronous. Submit a batch, poll its job, then retrieve results.

POST /api/v1/batches Submit 1–100 wallets ›

JSON body

{
  "addresses": ["0x59050e6c37ed6bdd003966af9b061757c7f04757"],
  "note": "optional public note"
}

Returns {"job_id":"UUID","total":1}.

GET /api/v1/batches/{job_id} Check status and progress ›

Poll every 2–5 seconds. Status is queued, processing, done, or error.

GET /api/v1/batches/{job_id}/results Get JSON or CSV results ›

Use /results for JSON or /results.csv for a downloadable CSV.

Keep job IDs private. The ID grants access to that batch’s results.

Query parameters

Pagination and output 6 parameters

pageinteger · default 1

Page number.

per_pageinteger · default 50

Rows per page; maximum 250.

sort_byfield · total_profit

Any field from /v1/fields.

orderasc | desc

Sort direction.

fieldsCSV

Fields to include in each wallet.

searchstring

Partial address search.

Profit and win rate 4 parameters

min_profitnumber

Minimum total profit.

max_profitnumber

Maximum total profit.

min_winrate0–100

Minimum 30-day win rate.

max_winrate0–100

Maximum 30-day win rate.

Additional filters 5 parameters

fdv_onlyboolean

Require FDV enrichment.

min_tokensinteger

Minimum analyzed tokens.

max_tokensinteger

Maximum analyzed tokens.

updated_sinceISO 8601

Only recently updated records.

filtersJSON

Advanced numeric ranges by field.

Recipes

Build a wallet leaderboard

GET /v1/wallets?sort_by=total_profit&order=desc&fields=address,total_profit,winrate_30d

Sync recently updated wallets

GET /v1/wallets?updated_since=2026-07-29T00:00:00Z&page=1&per_page=250

Enrich a private wallet list

POST a batch, poll the returned job ID until done, then fetch /results.

Limits and errors

120/minDatabase requests per IP

250Maximum rows per request

100Maximum wallets per batch

48hBatch result retention

400 Invalid parameters or body 404 Wallet or job not found 409 Results requested before completion 429 Rate limit or active-job restriction 503 Processing queue full