{"id":50342495,"url":"https://github.com/Mintbase/ref-finance-agent-next","last_synced_at":"2026-06-15T09:01:01.857Z","repository":{"id":238741043,"uuid":"797417480","full_name":"Mintbase/ref-finance-agent-next","owner":"Mintbase","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-21T18:21:52.000Z","size":416,"stargazers_count":1,"open_issues_count":1,"forks_count":13,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-02-21T18:30:12.698Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://ref-finance-agent-next.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mintbase.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-07T19:41:16.000Z","updated_at":"2025-02-21T18:21:57.000Z","dependencies_parsed_at":"2024-06-05T00:24:42.209Z","dependency_job_id":"19942311-07e1-45be-88fb-2ecd1d9e02a4","html_url":"https://github.com/Mintbase/ref-finance-agent-next","commit_stats":null,"previous_names":["mintbase/ref-finance-agent-next"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Mintbase/ref-finance-agent-next","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mintbase%2Fref-finance-agent-next","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mintbase%2Fref-finance-agent-next/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mintbase%2Fref-finance-agent-next/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mintbase%2Fref-finance-agent-next/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mintbase","download_url":"https://codeload.github.com/Mintbase/ref-finance-agent-next/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mintbase%2Fref-finance-agent-next/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34355156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-29T18:00:25.258Z","updated_at":"2026-06-15T09:01:01.462Z","avatar_url":"https://github.com/Mintbase.png","language":"TypeScript","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"# Ref Finance DeFi Swap Agent\n\n\u003cimg src=\"https://github.com/user-attachments/assets/aa54bac4-30ef-49bb-bac7-732ff561bd95\" alt=\"cover_image\" width=\"0\"/\u003e\n\nRef Finance Agent is a template for creating a Bitte.ai Plugin for facilitating DeFi swaps using Ref Finance. Built using Next.js 14 + Elysia.\n\n[![Demo](https://img.shields.io/badge/Demo-Visit%20Demo-brightgreen)](https://ref-finance-agent-next.vercel.app/)\n[![Deploy](https://img.shields.io/badge/Deploy-on%20Vercel-blue)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FMintbase%2Fref-finance-agent-next)\n\n**Tooling:**\n\n[![Use Case](https://img.shields.io/badge/Use%20Case-AI-blue)](#)\n[![Framework](https://img.shields.io/badge/Framework-Next.js%2014-blue)](#)\n\n## Project Walkthrough\n\nRef Finance Agent facilitates the development of AI-powered DeFi swap agents. The template supports creating, managing, and deploying DeFi swap functionalities. [Build your own agent](https://docs.bitte.ai/agents)\n\n#### API Base URL\n\nhttps://ref-finance-agent.vercel.app\n\n#### Endpoints\n\n- Token Metadata `GET` `/api/token/{token}`\n\n- Swap Transactions `GET` `/api/swap/{tokenIn}/{tokenOut}/{quantity}`\n\n#### Usage\n\nMake LLM requests to the endpoints above. Refer to the full API documentation for detailed parameter and response information.\n\n## Getting Started\n\n[Docs to integrate](https://docs.bitte.ai/agents/quick-start)\n\n### Installation\n\nCopy `.env.example` to `.env` and set the required environment variables.\n\n```bash\ncp .env.example .env\n```\n\nGet BITTE_API_KEY at [key.bitte.ai](https://key.bitte.ai).\n\nInstall dependencies and start development.\n\n```bash\n# install dependencies\npnpm i\n\n# start the development server\npnpm dev\n\n# test the agent using make-agent\npnpm make-agent dev\n\n# host the agent on a https url i.e. https://ref-finance-agent.vercel.app\n\n# Add to Bitte Registry using make-agent deploy\npnpm make-agent deploy -u \u003cyour-agent-url\u003e\n\n# test the agent using the Bitte Playground (agent-id is url without http or https i.e. ref-finance-agent.vercel.app)\nhttps://wallet.bitte.ai/smart-actions?mode=debug\u0026agentId=\u003cagent-id\u003e\n\n```\n\n## Local Development Using Tunneling\n\n1. Run dev server `pnpm run dev`\n2. Activate tunneling service (ngrok, localtunnel, serveo, pinggy, etc.)\n3. Deploy a temporary agent `pnpm make-agent deploy -u \u003ctunnel-url\u003e` (agents with tunnel urls are only temporary)\n4. Test the agent using the Bitte Playground https://wallet.bitte.ai/smart-actions?mode=debug\u0026agentId=\u003cagent-id\u003e\n\n### Example\n\n```bash\n# Run dev server\npnpm run dev\n\n# Activate tunneling service\nngrok http 3000\n\n# Deploy a temporary agent\npnpm make-agent deploy -u https://example-agent.ngrok.app\n\n# Test the agent on the Bitte Wallet Playground\nhttps://wallet.bitte.ai/smart-actions?mode=debug\u0026agentId=example-agent.ngrok.app\n```\n\n## Demo\n\nhttps://github.com/Mintbase/ref-finance-agent-next/assets/838839/3291eaf9-aa79-4c95-8c5f-673a6d72dc96\n\n## Deploy on Vercel\n\nThe easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template\u0026filter=next.js\u0026utm_source=create-next-app\u0026utm_campaign=create-next-app-readme) from the creators of Next.js.\n\nCheck out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.\n\n\u003cimg src=\"https://i.imgur.com/fgFX6BS.png\" alt=\"detail_image\" width=\"0\"/\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMintbase%2Fref-finance-agent-next","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMintbase%2Fref-finance-agent-next","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMintbase%2Fref-finance-agent-next/lists"}