{"id":35739196,"url":"https://github.com/fireflyprotocol/bluefin7k-typescript-sdk","last_synced_at":"2026-03-05T13:08:51.910Z","repository":{"id":297267034,"uuid":"996245262","full_name":"fireflyprotocol/bluefin7k-typescript-sdk","owner":"fireflyprotocol","description":"Bluefin7k aggregator SDK","archived":false,"fork":false,"pushed_at":"2026-03-04T18:07:10.000Z","size":186,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-05T00:06:39.496Z","etag":null,"topics":["library","team-eng-expansion"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fireflyprotocol.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-04T17:05:03.000Z","updated_at":"2026-03-04T18:11:34.000Z","dependencies_parsed_at":"2025-06-04T22:38:22.452Z","dependency_job_id":"e8309bbb-e14c-4b6b-889b-37a99b06a922","html_url":"https://github.com/fireflyprotocol/bluefin7k-typescript-sdk","commit_stats":null,"previous_names":["fireflyprotocol/bluefin7k-typescript-sdk"],"tags_count":27,"template":false,"template_full_name":null,"purl":"pkg:github/fireflyprotocol/bluefin7k-typescript-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fireflyprotocol%2Fbluefin7k-typescript-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fireflyprotocol%2Fbluefin7k-typescript-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fireflyprotocol%2Fbluefin7k-typescript-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fireflyprotocol%2Fbluefin7k-typescript-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fireflyprotocol","download_url":"https://codeload.github.com/fireflyprotocol/bluefin7k-typescript-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fireflyprotocol%2Fbluefin7k-typescript-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30121483,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T11:11:57.947Z","status":"ssl_error","status_checked_at":"2026-03-05T11:11:29.001Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["library","team-eng-expansion"],"created_at":"2026-01-06T14:12:32.001Z","updated_at":"2026-03-05T13:08:51.901Z","avatar_url":"https://github.com/fireflyprotocol.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bluefin7k Aggregator TypeScript SDK\n\n## Installation\n\n```bash\nnpm i @bluefin-exchange/bluefin7k-aggregator-sdk\n```\n\nThis package requires `@pythnetwork/pyth-sui-js` as a peer dependency. If your\nproject does not have it, you need to install it.\n\n```bash\nnpm i @pythnetwork/pyth-sui-js\n```\n\n## Usage\n\nYou can import the entire SDK as a module:\n\n```typescript\nimport SevenK from \"@bluefin-exchange/bluefin7k-aggregator-sdk\";\n```\n\nor import specific functions as needed:\n\n```typescript\nimport { getQuote, buildTx } from \"@bluefin-exchange/bluefin7k-aggregator-sdk\";\n```\n\n## Config\n\nConfiguration is optional, but if provided, it must be set before invoking any\nSDK functions.\n\n### Set API Key\n\nYou can use our SDK with a default rate limit of **5 requests per second**\nwithout needing an API key.\n\n- For **frontend (in-browser) usage**, no API key is required, and the rate\n  limit cannot be increased.\n\n- For **backend (server-side) usage**, the API key is **optional** for default\n  usage. However, to request a **higher rate limit**, you must provide both an\n  **API key** and **partner information**.\n\nTo request a rate limit increase, please submit your request at our [Discord](https://discord.gg/bluefinapp).\nCreate a ticket to request an API key for Bluefin7k Aggregator.\n\n| Usage    | API Key Required                      | Default Rate Limit              | Can Request Higher Rate Limit                |\n| -------- | ------------------------------------- | ------------------------------- | -------------------------------------------- |\n| Frontend | No                                    | 5 requests/second               | No                                           |\n| Backend  | Optional (required to increase limit) | 5 requests/second (without key) | Yes (requires API Key \u0026 partner information) |\n\n```typescript\nimport { Config } from \"@bluefin-exchange/bluefin7k-aggregator-sdk\";\n\nConfig.setApiKey(\"YOUR_API_KEY\");\nconsole.log(\"API key\", Config.getApiKey());\n```\n\n### Set BluefinX API key\n\nSetting a BluefinX API key is optional. However, if you'd like to use one — for\nexample, to avoid rate limits when routing through BluefinX — you'll need to\nrequest an API key directly from Bluefin.\n\n```typescript\nimport { Config } from \"@7kprotocol/sdk-ts\";\n\nConfig.setBluefinXApiKey(\"YOUR_BLUEFINX_API_KEY\");\nconsole.log(\"BluefinX API key\", Config.getBluefinXApiKey());\n```\n\n### Set Sui Client\n\n```typescript\nimport { SuiClient, getFullnodeUrl } from \"@mysten/sui/client\";\nimport { Config } from \"@bluefin-exchange/bluefin7k-aggregator-sdk\";\n\nconst network = \"mainnet\";\nconst suiClient = new SuiClient({ url: getFullnodeUrl(network) });\nConfig.setSuiClient(suiClient);\nconsole.log(\"Sui client\", Config.getSuiClient());\n```\n\nNote: this package only supports **mainnet**.\n\n### Set Endpoint Provider (API Version)\n\nYou can toggle between different API versions:\n\n- `\"Bluefin7k\"` (default) - Uses `v2/quote` endpoint\n- `\"Bluefin7kV2\"` - Uses `v3/quote` endpoint with RFQ support\n\n```typescript\nimport { Config } from \"@bluefin-exchange/bluefin7k-aggregator-sdk\";\n\n// Use v2 API (default)\nConfig.setEndpointProvider(\"Bluefin7k\");\n\n// Use v3 API with RFQ support\nConfig.setEndpointProvider(\"Bluefin7kV2\");\n```\n\n## Swap\n\nSee [Swap](docs/SWAP.md).\n\n## BluefinX\n\nSee [BluefinX](docs/BLUEFINX.md).\n\n## Limit Orders\n\nSee [Limit Orders](docs/LIMIT.md).\n\n## DCA Orders\n\nSee [DCA Orders](docs/DCA.md).\n\n## Prices\n\n```typescript\nimport { getTokenPrice, getTokenPrices, getSuiPrice } from \"@bluefin-exchange/bluefin7k-aggregator-sdk\";\n\nconst tokenPrice = await getTokenPrice(\n  \"0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC\",\n);\n\nconst tokenPrices = await getTokenPrices([\n  \"0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI\",\n  \"0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC\",\n]);\n\nconst suiPrice = await getSuiPrice();\n```\n\n## Miscellaneous\n\nIf you encounter issues when importing functions from this SDK in a Node.js\nenvironment, refer to [src/examples/nodejs/](./src/examples/nodejs/) for\nguidance.\n\n## License\n\nBluefin7k Aggregator TypeScript SDK released under the MIT license. See the [LICENSE](./LICENSE)\nfile for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffireflyprotocol%2Fbluefin7k-typescript-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffireflyprotocol%2Fbluefin7k-typescript-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffireflyprotocol%2Fbluefin7k-typescript-sdk/lists"}