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.

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

ChainID da chainSwaps (cotação + transação não assinada)Dados
Ethereum1simtokens, negociações, candles, PnL de carteira
Monad143simtokens, negociações, candles, PnL de carteira, smart money, LP
Robinhood Chain4663simtokens, negociações, candles, PnL de carteira, smart money, holders, LP
Arc5042simtokens, negociações, candles, PnL de carteira, smart money, holders, LP
Avalanche C-Chain43114simtokens, negociações, candles, PnL de carteira
Base8453simtokens, negociações, candles, PnL de carteira
BNB Chain56simtokens, negociações, candles, PnL de carteira
Arbitrum One42161simtokens, negociações, candles, PnL de carteira
Solananenhumsim, 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

PastaConteú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):

ContratoEndereç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)

ContratoEndereço
Implementação do ChordRouter (atualizada em 2026-10-02)0x209e38890533469337488588cB9e4A44943EE8FE
Adapter Uniswap V40x3622116c527896Ab9C1510A45f3344AaBD03973a
Adapter V3 any-fork (Uniswap V3, Ramses e outros forks V3)0x3A7D13a420c8FBC29Bf4A1feDB22A5Dae3A8913E
Adapter V20xC4b930D9E5d20cc8b4C67f2118FE0cD8E6e36b72
Adapter Algebra0x63bd5402aCC3129c9b38c7d52f327b82f24B497D
RhStockZap0x66627Ce32af8801525930B7C2a1Db4905193bb51

Atualização do roteador na Robinhood Chain: tx 0x9111f311319d778d2b53cce16fe7d471a15e61b8e00bdd08de074a5bcc571aa3.

Arbitrum One (ID da chain 42161, implantado em 2026-10-14)

ContratoEndereço
Implementação do ChordRouter0x1cd8CeED960dE0c9787295c8F1BF278D4A36698c
ChordV3Adapter (Uniswap V3, PancakeSwap V3, SushiSwap V3)0xd55fe37e30435cF15fe2C7fcAAF1aBf19d13b195
ChordV2Adapter (Uniswap V2, SushiSwap V2)0xa61C202C4c989a1724E1B432C96A9f064856574d
ChordV4Adapter0xFE82b7714c36083AB518067f03680C59ac57840a
ChordMetricV1Adapter0x4e48D8bEDB4A781493e6193776FDa37e57Ce07b1
ChordAlgebraIntegralAdapter (Camelot V3)0x3D26860E5d5ddE28FDcd11e14573CE7b103fA081
ChordWooFiAdapter0xfdC2e11793197B9D16Ae1eDBa8049dcc9Fc15748
ChordDodoV2Adapter0x3E46e23C171aAC3124D85BbCa33A2C0422342fA4

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:

ContratoEndereço
Implementação do ChordRouter0x1cd8CeED960dE0c9787295c8F1BF278D4A36698c
ChordV3Adapter (Uniswap V3, PancakeSwap V3, SushiSwap V3)0xd55fe37e30435cF15fe2C7fcAAF1aBf19d13b195
ChordV2Adapter (Uniswap V2, SushiSwap V2)0xa61C202C4c989a1724E1B432C96A9f064856574d
ChordV4Adapter0xFE82b7714c36083AB518067f03680C59ac57840a

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 de approve(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.