Chord Top wallets API
Wallets ranked from the tape by a skill-adjusted score, with routers and bots removed.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/getchord-xyz:getchord-xyz-top-wallets-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Chord Top wallets API
version: '2026-10-05'
summary: Trade, data and agent endpoints for eight EVM chains (Ethereum 1, Arbitrum One 42161, Base 8453, BNB Chain 56, Avalanche 43114, Monad 143, Arc 5042, Robinhood Chain 4663) and Solana (data and swaps).
description: 'Chord is a non-custodial trading app and on-chain data index. The API has three kinds of endpoint:
- **Trade**: `/quote` finds the best route across every venue on the chain; `/swap` turns it into a transaction you sign yourself. Chord never holds funds or keys.
- **Read**: every swap on the chain, rolled up by token, venue and hour, from Chord''s own index — tokens, launches, holders, top wallets, portfolio PnL, liquidity positions and pools. No key needed. Avalanche, Base, BNB Chain, Arbitrum One and Ethereum have the same rollups under `/chains/{chain}/*`; Solana has its own data family under `/chains/solana/*` (base58 addresses, case-sensitive) and its swaps under `/sol/trade/*`.
- **Agent**: the analyst (`/ask`) and the streams.
Amounts are decimal strings in the token''s smallest unit. Timestamps are Unix seconds unless the field is `updatedAt` (milliseconds). `GET /portfolio/{wallet}` and `/portfolio/{wallet}/activity` differ on both: amounts there are in whole tokens and every time is in milliseconds. Reads answer anonymous callers at 60 requests a minute per IP; an `X-API-Key` header raises that to your plan. Every non-2xx body is `{ error, message }`.'
contact:
name: Chord
url: https://getchord.xyz/developer
x-logo:
url: https://getchord.xyz/chord/pwa-192x192.png?v=20261019
servers:
- url: https://api.getchord.xyz/v1
description: Production
tags:
- name: Top wallets
description: Wallets ranked from the tape by a skill-adjusted score, with routers and bots removed.
paths:
/smart-money/top:
get:
tags:
- Top wallets
operationId: smartMoneyTop
summary: Wallets ranked by Smart Score
description: 'Which wallets make money on the chain, from the tape, ranked by a skill-adjusted score rather than raw profit (realized-weighted, luck-corrected, recency-decayed). Routers, executors, bots and the extra wallets of one operator are removed before ranking (`botsRemoved` counts them). On Arc the board moves between rebuilds: a live delta of the last minutes'' trades sits on top of the last roll (`live`).
**Notes**: `source=onchain` is required on 5042 / 4663. The board is rebuilt on a schedule per window (15 min for 24h, hourly for 7d / 30d, 3 h for all) and served from cache in between. `503 CHAIN_NOT_ENABLED` until the board is published for the chain.'
parameters:
- name: chain
in: query
required: true
schema:
type: integer
enum:
- 5042
- 4663
- 143
default: 143
description: 'Chain id: `5042` Arc · `4663` Robinhood Chain · `143` Monad. Omitted = 143.'
- name: source
in: query
required: true
schema:
type: string
enum:
- onchain
- nullterminal
description: '`onchain` = every venue, from the tape. Required on 5042 and 4663.'
- name: window
in: query
required: false
schema:
type: string
enum:
- 24h
- 7d
- 30d
- all
default: all
description: ''
- name: category
in: query
required: false
schema:
type: string
enum:
- all
- memes
- majors
default: all
description: ''
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
default: 50
description: ''
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties:
wallets:
type: array
items:
$ref: '#/components/schemas/SmartWallet'
totalWallets:
type: integer
description: Wallets that qualified after the bot passes.
window:
type: string
description: ''
category:
type: string
description: ''
chain:
type: integer
description: ''
source:
type: string
description: ''
indexedToBlock:
type: integer
description: The chain block the tape had reached when this board was built.
updatedAt:
type: integer
description: Unix time, milliseconds — when the server built this answer.
live:
type: object
additionalProperties: true
description: Arc only — the in-memory delta on top of the last roll.
botsRemoved:
type: object
properties:
cadence:
type: integer
description: ''
nonceOrDenylist:
type: integer
description: ''
behavior:
type: integer
description: ''
cluster:
type: integer
description: 'Wallets of one operator folded into its best-ranked wallet: three or more wallets whose first buys of the same five or more tokens landed within 10 seconds of each other. Robinhood Chain, Monad and Arc.'
warming:
type: boolean
description: 'Present (true) only on an empty answer for a board that has not been computed yet, for example right after a restart: ask again in a few minutes.'
unavailable:
type: boolean
description: 'Present (true) only on an empty answer for a window the index cannot build for this chain right now (Arc all-time): no compute is coming, ask for another window. An empty list without warming or unavailable means no wallet qualified.'
note:
type: string
description: ''
example:
wallets:
- wallet: '0xb145400da27a2497d9fc2cd5621f2bfd37617af4'
pnlUsd: 85260.25886163529
realizedUsd: 28166.924288181075
unrealizedUsd: 57093.33457345421
volumeUsd: 68986.38694614707
trades: 49
tokensTraded: 5
winningTokens: 3
winRate: 0.6
topToken:
symbol: ARGUS
pnlUsd: 85345.61369765387
lastActiveTs: 1789890946
pnlMeme: 85260.25886163529
pnlMajor: 0
memeVol: 68986.38694614707
archetype: degen
memeShare: 1
winRateAdj: 0.5294117647058824
smartScore: 43067.763434718785
- wallet: '0xf8218b98f49b86c7e491079591acc08ee4fd6e7e'
pnlUsd: 53891.271617383565
realizedUsd: 26940.46261686956
unrealizedUsd: 26950.809000514004
volumeUsd: 150140.03604099998
trades: 70
tokensTraded: 11
winningTokens: 9
winRate: 0.8181818181818182
topToken:
symbol: ARGUS
pnlUsd: 22862.25828632662
lastActiveTs: 1789890046
pnlMeme: 53891.271617383565
pnlMajor: 0
memeVol: 150140.03604099998
archetype: degen
memeShare: 1
winRateAdj: 0.6521739130434783
smartScore: 32966.26695083121
totalWallets: 92826
window: 7d
category: all
chain: 5042
source: onchain
indexedToBlock: 21808217
updatedAt: 1789891859855
live:
rollStamp: 1789891728
buckets: 21
rows: 253
seen: 1261
ingested: 1261
skippedDup: 0
computedAt: 0
botsRemoved:
cadence: 325
nonceOrDenylist: 5
behavior: 37
note: ranked by Smart Score — skill-adjusted, realized-weighted profit (est. at current prices)
'400':
description: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: The lane behind this endpoint is not ready or not enabled here (`NOT_READY`, `CHAIN_NOT_ENABLED`, `NOT_ENABLED`, `*_UNAVAILABLE`). Retry later; do not treat it as an empty answer.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
Error:
type: object
properties:
error:
type: string
description: Stable machine code, e.g. `INVALID_PARAMS`, `NOT_READY`, `RATE_LIMIT_EXCEEDED`.
message:
type: string
description: For humans.
statusCode:
type: integer
description: HTTP status, when included.
description: Every non-2xx body.
required:
- error
example:
error: INVALID_PARAMS
message: amount must be an integer string in the token's smallest unit
SmartWallet:
type: object
properties:
wallet:
type: string
pattern: ^0x[a-fA-F0-9]{40}$
description: EVM address, hex, case-insensitive.
pnlUsd:
type: number
description: Realized plus open PnL at current prices.
realizedUsd:
type: number
description: ''
unrealizedUsd:
type: number
description: ''
volumeUsd:
type: number
description: ''
trades:
type: integer
description: ''
tokensTraded:
type: integer
description: ''
winningTokens:
type: integer
description: ''
winRate:
type: number
description: 0–1.
topToken:
type: object
properties:
symbol:
type:
- string
- 'null'
description: ''
pnlUsd:
type: number
description: ''
lastActiveTs:
type: integer
description: Unix time, seconds, UTC.
pnlMeme:
type: number
description: ''
pnlMajor:
type: number
description: ''
memeVol:
type: number
description: ''
archetype:
type: string
description: '`degen` · `allrounder` · `majors` …'
memeShare:
type: number
description: ''
winRateAdj:
type: number
description: Luck-corrected win rate.
smartScore:
type: number
description: 'The ranking key: realized-weighted, luck-corrected, recency-decayed profit.'
securitySchemes:
ApiKey:
type: apiKey
in: header
name: X-API-Key
description: Optional on every read. A key from getchord.xyz/developer raises the rate limit to your plan and meters usage per key. Required for `?only=` on quotes and for the Ask agent API.
Session:
type: http
scheme: bearer
description: A Google sign-in session minted by the app (`nts_…`). Only the browser surfaces use it; agents use `ApiKey`.