Chord
Troque cotações + transações não assinadas em 7 cadeias EVM, quadros de tokens, velas, PnL de carteira, dinheiro inteligente. Sem chave.
Servidor MCP hospedado
npx add-mcp 'https://api.getchord.xyz/v1/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Chord
API de negociação sem custódia e agente de IA. Uma única chamada de cotação encontra a melhor rota entre as DEXs de oito chains EVM (Ethereum, Monad, Robinhood Chain, Arc, Avalanche, Base, BNB Chain e Arbitrum One), e um único contrato de roteador a executa em uma única transação. Na Solana, a Chord cotas swaps através do seu próprio roteador Solana e da Jupiter e retorna uma transação não assinada para a carteira do usuário. Além da negociação, a Chord mantém um índice ao vivo de swaps, holders, posições de LP e PnL de carteiras em todas as nove chains, que aplicativos e agentes de IA podem consultar.
- App (Ask, agente de negociação de IA + carteira): https://getchord.xyz/ask
- Documentação e referência da API: https://getchord.xyz/docs
- API: https://api.getchord.xyz/v1 (o que cada chain atende: https://api.getchord.xyz/v1/chains)
- Status, medido a cada minuto pela Cloudflare: https://getchord.xyz/status
- Servidor MCP hospedado:
https://api.getchord.xyz/v1/mcp
A Chord começou como NullTerminal, um agregador de DEX na Monad. Nomes de contratos e pacotes que começam com Null vêm
desse período; os contratos Chord* em contracts/src/chord/ são as versões atuais do mesmo código.
Use a partir de um agente de IA
O servidor MCP hospedado não precisa de chave nem instalação (Streamable HTTP). ?chain=<key> fixa uma chain padrão.
claude mcp add --transport http chord https://api.getchord.xyz/v1/mcp
gemini extensions install https://github.com/getchordlabs/chord # Gemini CLI, reads gemini-extension.json
17 ferramentas, cada uma recebendo um chain: chord_chains, chord_status, chord_overview, chord_tokens, chord_search,
chord_token, chord_trades, chord_candles, chord_wallet, chord_wallet_trades, chord_smart_money,
chord_holders, chord_lp_pools, chord_lp_positions, chord_quote, chord_swap_tx e chord_ask. Nada assina
ou envia: chord_swap_tx retorna uma transação não assinada, a aprovação necessária e uma simulação executada como o tomador.
Listado no Registro MCP oficial como io.github.getchordlabs/chord (server.json neste repositório) e na
Smithery como tuantqse90/chord. Outras formas de acesso: a API REST com sua
especificação OpenAPI (openapi/), a Skill de Agente (skills/chord/), o MCP de Documentação em https://getchord.xyz/docs/mcp e o
manifesto de chamada de funções em https://api.getchord.xyz/v1/mcp/tools.json.
Chains
| Chain | ID da chain | Swaps (cotação + transação não assinada) | Dados |
|---|---|---|---|
| Ethereum | 1 | sim | tokens, negociações, candles, PnL de carteira |
| Monad | 143 | sim | tokens, negociações, candles, PnL de carteira, smart money, LP |
| Robinhood Chain | 4663 | sim | tokens, negociações, candles, PnL de carteira, smart money, holders, LP |
| Arc | 5042 | sim | tokens, negociações, candles, PnL de carteira, smart money, holders, LP |
| Avalanche C-Chain | 43114 | sim | tokens, negociações, candles, PnL de carteira |
| Base | 8453 | sim | tokens, negociações, candles, PnL de carteira |
| BNB Chain | 56 | sim | tokens, negociações, candles, PnL de carteira |
| Arbitrum One | 42161 | sim | tokens, negociações, candles, PnL de carteira |
| Solana | nenhum | sim, através de /v1/sol/trade/* (ainda não nas ferramentas MCP) | tokens, negociações, candles, PnL de carteira, traders inteligentes, LP |
GET /v1/chains responde à mesma tabela com a rota por trás de cada capacidade (swaps na Solana ficam em
/v1/sol/trade/*, fora dessa tabela).
O que há neste repositório
| Pasta | Conteúdo |
|---|---|
contracts/ | Projeto Foundry: ChordRouter (UUPS), AdapterRegistry, FeeCollector, um adapter por família de venue (Uniswap V2/V3/V4, Algebra e Algebra Integral, Solidly, Liquidity Book, PancakeSwap Infinity, Metric, WOOFi, DODO V2, depósito ERC-4626, Curve, Balancer e mais), RhStockZap / RhTokenZap para compras cross-chain na Robinhood Chain, SwapAndBridgeCCTP, scripts de deploy e testes de fork por chain |
agent/ | chord-agent: uma ponte stdio para o servidor MCP hospedado para clientes que só falam stdio, e o manifesto de chamada de funções (tools.json) |
skills/chord/ | Skill de Agente para Claude Code, Codex e outros agentes: SKILL.md, referências com saída de API ao vivo, cliente chord.py |
docs-mcp/ | Servidor MCP de Documentação (stdio, e hospedado em https://getchord.xyz/docs/mcp) |
openapi/ | Especificação OpenAPI da API pública (openapi.json) e o script que a gera |
sdk/ | O SDK TypeScript original do período Monad |
O mecanismo de roteamento (Rust) e o servidor de API (TypeScript) não estão neste repositório. Eles rodam por trás de
api.getchord.xyz.
Contratos
Os três proxies estão nos mesmos endereços em todas as oito chains EVM (nonces de deploy alinhados):
| Contrato | Endereço |
|---|---|
| ChordRouter (proxy UUPS) | 0x1b1fee89a381e595fe6536b99ba91f3e16e9601a |
| AdapterRegistry (proxy UUPS) | 0x6cf25d2af1a58d7094b0ac253ae616a8e1f2ea3f |
| FeeCollector (proxy UUPS) | 0x6c66229675fd9ceda9a9b2ea2bd983b3d8255834 |
Cada adapter fixa o roteador como imutável e reverte NotRouter para qualquer outro chamador. O roteador só chama
adapters aprovados pelo registro. As taxas são definidas on-chain por FeeCollector.feeBpsFor(outputToken): 5 bps por padrão em
cada chain, 0 bps para stablecoins, moedas principais e as ações tokenizadas listadas na Robinhood Chain.
Robinhood Chain (ID da chain 4663)
| Contrato | Endereço |
|---|---|
| Implementação do ChordRouter (atualizada em 2026-10-02) | 0x209e38890533469337488588cB9e4A44943EE8FE |
| Adapter Uniswap V4 | 0x3622116c527896Ab9C1510A45f3344AaBD03973a |
| Adapter V3 any-fork (Uniswap V3, Ramses e outros forks V3) | 0x3A7D13a420c8FBC29Bf4A1feDB22A5Dae3A8913E |
| Adapter V2 | 0xC4b930D9E5d20cc8b4C67f2118FE0cD8E6e36b72 |
| Adapter Algebra | 0x63bd5402aCC3129c9b38c7d52f327b82f24B497D |
| RhStockZap | 0x66627Ce32af8801525930B7C2a1Db4905193bb51 |
Atualização do roteador na Robinhood Chain: tx 0x9111f311319d778d2b53cce16fe7d471a15e61b8e00bdd08de074a5bcc571aa3.
Arbitrum One (ID da chain 42161, implantado em 2026-10-14)
| Contrato | Endereço |
|---|---|
| Implementação do ChordRouter | 0x1cd8CeED960dE0c9787295c8F1BF278D4A36698c |
| ChordV3Adapter (Uniswap V3, PancakeSwap V3, SushiSwap V3) | 0xd55fe37e30435cF15fe2C7fcAAF1aBf19d13b195 |
| ChordV2Adapter (Uniswap V2, SushiSwap V2) | 0xa61C202C4c989a1724E1B432C96A9f064856574d |
| ChordV4Adapter | 0xFE82b7714c36083AB518067f03680C59ac57840a |
| ChordMetricV1Adapter | 0x4e48D8bEDB4A781493e6193776FDa37e57Ce07b1 |
| ChordAlgebraIntegralAdapter (Camelot V3) | 0x3D26860E5d5ddE28FDcd11e14573CE7b103fA081 |
| ChordWooFiAdapter | 0xfdC2e11793197B9D16Ae1eDBa8049dcc9Fc15748 |
| ChordDodoV2Adapter | 0x3E46e23C171aAC3124D85BbCa33A2C0422342fA4 |
Todos verificados no Sourcify. Cada venue foi negociado nos dois sentidos na mainnet através do roteador antes de o mecanismo rotear por ele.
Ethereum (ID da chain 1, implantado em 2026-10-15)
Mesmos endereços da Arbitrum One para a implementação do roteador e os três adapters principais:
| Contrato | Endereço |
|---|---|
| Implementação do ChordRouter | 0x1cd8CeED960dE0c9787295c8F1BF278D4A36698c |
| ChordV3Adapter (Uniswap V3, PancakeSwap V3, SushiSwap V3) | 0xd55fe37e30435cF15fe2C7fcAAF1aBf19d13b195 |
| ChordV2Adapter (Uniswap V2, SushiSwap V2) | 0xa61C202C4c989a1724E1B432C96A9f064856574d |
| ChordV4Adapter | 0xFE82b7714c36083AB518067f03680C59ac57840a |
Todos os 9 contratos da pilha correspondem no Sourcify; cada venue foi negociado nos dois sentidos na mainnet antes de se tornar público.
Build e teste
git submodule update --init --recursive
cd contracts
forge build
forge test --no-match-contract 'ForkTest$'
Desde o buildathon (5 a 15 de outubro de 2026)
- Arbitrum One: pilha Chord alinhada, script de deploy e teste de fork (
edd957a), swaps e o lado Ask (c28203c), público em 15 de outubro (ca79736). - Ethereum: pilha Chord alinhada, script de deploy e teste de fork (
79233bc), swaps e o lado Ask (8a46f39), tokens que precisam deapprove(0)primeiro, como USDT (69a06af), público em 15 de outubro (38b466e). - Novos venues: Metric v1 na Monad e Avalanche (
80daf2c,23bfe8c), depósito ERC-4626 na Monad, que cunha aprMON, shMON e gMON à taxa do vault quando os pools precificam abaixo dela (a41a703), WOOFi (83283af), Camelot V3 através do adapter Algebra Integral (454091c), DODO V2 na Avalanche e Arbitrum (1975d08), LFJ Liquidity Book v2.1 (147f862), e duas fábricas de liquidez concentrada na Arc através do ChordV3Adapter r3 (95e65be). - Agentes: o agente stdio virou uma ponte para o servidor MCP hospedado (
02f7201), negociações de carteira em cada chain (5256c20), dados da Solana, traders inteligentes e rotas de LP na especificação OpenAPI e na skill (710b14d,74957c2,d13d3ef), uma página de documentação por rede (0306a08). - Swaps na Solana: roteador Solana próprio da Chord e Jupiter na documentação pública e na skill (
ee2d912), aberto a todos em 15 de outubro (41b3fdc).
Trabalho realizado durante o Arbitrum Open House Singapore Buildathon (13 de setembro a 4 de outubro de 2026)
A Chord existia antes do buildathon. Este repositório foi extraído do nosso monorepo com seu histórico real de commits
para estas pastas, então todo commit datado de 2026-09-13 ou posterior foi feito durante ou após o buildathon
(git log --since=2026-09-13). Destaques:
- ChordRouter: implementações com nome Chord de roteador, registro e coletor de taxas (
08dcb96), e um script que atualiza apenas o proxy do roteador, usado na Robinhood Chain, Monad e Arc em 2 de outubro (dfb5386). - Compras cross-chain na Robinhood Chain: RhTokenZap, um zap de destino genérico através do roteador, e
SwapAndBridgeCCTP, swap mais queima CCTP da Circle em uma única chamada (
9814cba). - Novos adapters: UniV2TaxSafeAdapter, precificado pelo que o par realmente recebeu (
0dc387b); Uniswap V4 com USDC nativo na Arc (0cc5ff3); ChordSolidlyAdapter (3775c10,f9a6fae); ChordLBPairAdapter (b3136f1); ChordAlgebraIntegralAdapter (b20d1de); ChordInfinityCLAdapter (95db92d). - Superfícies de agente: Skill de Agente (
014875e), MCP de Documentação (54ffb71), ferramentas de agente para Arc, LP e o meta-agregador (98cd499,d751aeb,ad9f222), especificação OpenAPI mantida em linha com a API (3c4ea54,5130d2a). - Carteira Ask na Robinhood Chain (principalmente na API fechada e no aplicativo web, parcialmente aqui): USDC na Arbitrum converte
para USDG na Robinhood Chain com uma assinatura (
609f37a), Convert explícito e carteira multi-chain (f2b4244).
Licença
MIT, veja LICENSE. Ela cobre tudo neste repositório: contratos, agente, skill, MCP de Documentação, especificação OpenAPI
e SDK. Os submódulos em contracts/lib/ mantêm suas próprias licenças (OpenZeppelin MIT, forge-std MIT ou Apache-2.0).
Fontes verificadas on-chain antes de 2026-10-15 ainda leem SPDX-License-Identifier: UNLICENSED; o código é o mesmo e
é MIT a partir dessa data.